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I, each and every one of the undersigned inventors of the above-referenced patent 
application, hereby declare the following: 

1) The pending claims of our above identified patent invention. were rejected under 
35 U.S.C. § 103(a) based on the prior art of Kutay et al., (U.S. Pat. Pub. No. 
2002/0026461 A1) with a filing date of June 5, 2001 and claiming priority to 
provisional application No. 60/209,713, filed on June 5, 2000. 

2) The invention described in the above-referenced patent application was reduced 
to a writing prior to the June 5, 2000 priority date of Kutay et al. In particular, 
Franklin Content Management Prototype documentation (exhibit A), upon which 
the above referenced patent application was based, is attached herewith. The 
documentation is a comprehensive specification and installation of the inventive 
system (see the table of contents of this document for the full detail) created and 
used by the inventors prior to the June 5, 2000 priority date of Kutay et al. and 
demonstrating features of the presently claimed invention. It includes everything 
from an Installation guide, configuration, setup of the DB and a Franklin 
workspace for content management, setting up of users, roles, and includes code 
snippets of communication between components and error codes. 

3) Additionally, the invention described in the above-referenced patent application 
was reduced to actual practice prior to the June 5, 2000 priority date of Kutay et 
al. Proof of actual reduction to practice upon which the presently claimed 
invention was based is attached herewith and will be described in detail below. 

4) Submitted herewith as evidence of actual reduction to practice prior to the June 
5, 2000 priority date of Kutay et al. are the following exhibits: 

Exhibit B: Assignments passed out to users prior to the June 5, 2000 priority 



date of Kutay et al. to test users who were evaluating the 
integration between two systems: the present invention and 
"Kittyhawk" prior to the June 5, 2000 priority date of Kutay et al. 
The scenarios ask users to do different actions in the present 
invention's Ul, which would show that there was a running system 
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that could support users prior to the June 5, 2000 priority date of 
Kutay et al. The document describes the integration of the two 
systems, and shows the request/responses part of the 
communication between the two systems. 

Exhibit C: A copy of a State chart of the invention's DB with each possible 
state of a fragment when stored in the invention's DB. The State 
chart was created and used by the inventors prior to the June 5, 
2000 priority date of Kutay et al. and demonstrates features of the 
presently claimed invention. 

Exhibit D: Copies of HTML pages created by the inventors prior to the June 5, 
2000 priority date of Kutay et al. and demonstrating features of the 
presently claimed invention. The HTML pages describe to users 
how to install the inventive client and issue commands to manage 
documents, such as Check in, Check out review, publish and 
describes the fragment/servable relationship to users. 

Exhibit E: A synthesis of all feedback from a user acceptance testing of the 
Invention, run prior to the June 5, 2000 priority date of Kutay et al. 
It includes a list of things users liked and did not like, which 
evidences that users were using the running end-to-end inventive 
system with features of the presently claimed invention prior to the 
June 5, 2000 priority date of Kutay et al. In particular, it is stated on 
page 3 (Executive Summary) that "Participants liked that 
Franklin:... Provides the ability to change content once and have 
the changes appear in multiple places..." 

Exhibit F: A copy of brief notes identified during a code review of the 
invention's server code made prior to the June 5, 2000 priority date 
of Kutay et al. 

Exhibit G: An email correspondence to persons other than the inventors of the 
present invention, listing the internet address for accessing, and 
instructions on how to use, the working prototype system created 
and used by the inventors prior to the June 5, 2000 priority date of 
Kutay et al. and demonstrating features of the presently claimed 
invention. 

Exhibit H: An email correspondence with reviewer feedback on the working 
prototype system created and used by the inventors prior to the 
June 5, 2000 priority date of Kutay et al. and demonstrating 
features of the presently claimed invention. 

Exhibit I: Copies of several screenshots of the working prototype system 
created and used by the inventors prior to the June 5, 2000 priority 
date of Kutay et al. and demonstrating features of the presently 
claimed invention. These screenshots show lists of XML 
documents having content objects and content fragments which are 
named and linked through the entry fields. 

Exhibit J: A copy of a section of the source code file that was created and 
used by the inventors prior to the June 5, 2000 priority date of 
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Kutay et al. and that implemented part of a working prototype 
system that performed features of the presently claimed invention. 

5) The evidence submitted herewith supports the reduction to practice. The 
following table is submitted to show how each claim element is supported and 
that the test results unequivocally establish this software existed and worked 
for its intended purpose. 

Claiml is an example. The other independent claims (9 & 19) recite identical 
limitations. 



Claim Elements Evidence In Exhibit 



definina a first XML document and a 


I) Exhibit A, page 11, item 6, step 6 states: "A 
fragment can include other fragments as 
subfragments..." 

II) Exhibit A, page 13, item 2 states: "A 
servable can include one or more 
subfragments..." 

III) Exhibit A, page 15, last paragraph states: 
"Because the servable includes content from 
subfragments..." 

IV) Exhibit A page 42 (Dependency Parser), 
the Franklin Dependency Parser reads through 
XML objects that have been checked in and 
detects two types of dependencies: 

I. Servables and fragments can include 
subfragments, these get stored as an edge 
of type "composition in the Daedalus Object 
Dependency Graph (ODG); 

II. Compound fragments include an 
associated content file, this dependency 
gets stored as an edge type "composition" 
in the ODG. 

Servables can include style sheets, these 
get stored as an edge type "stylesheet" in 
the ODG. 

V) Exhibit D, page 2 of 3 (first paragraph) A 
page includes one or more subfragments. ... 


second XML document based uoon 


one or more reusable content objects. 


wherebv at least one of the content 


objects includes at least one object 
dependency araoh that identifies 
content object dependency across the 
iirsi AiviL uQCurneru anu ine bt?uunu 
XML document usina one or more 
edaes denotina relationships between 
one or more of the content objects so 
as to provide synchronization of the 
content objects across the first XML 
document and the second XML 
document: 


buildina the first XML document 
so as to form a self-contained 
accumulation of the one or more 
content objects in accordance with the 


I) Exhibit A, page 15 (Step 7) "For each 
servable DTD, you need to define one or more 
XSL style sheets that will be assembled with 
the servable XML and the XML of any 
subfragment into the final published pages.../ 
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object deDendencv araDh: 


II) Exhibit A, page 15 (last paragraph) "Before 
page assembly, a servable is temporarily 
rewritten to include the content of all 
subfragments...." 


buildina the second XML 
document so as to form a self- 


Exhibit D, page 2 of 3 (Approval document) 
"For a fragment, the list consists of all final 
htm I nanp<5 nf all ^ervables that include the 
fragment as a subfragment. For a servable, 
the list consists of all final HTML pages of that 
servable." 


contained accumulation of the one or 


more content objects in accordance 


with the object deoendencY arapn. 


and 


in response to a value of the 
content objects beina modified, a 


I) Exhibit A, page 44 (first paragraph) "When a 
fragment is checked in to the Content Store ... 
.." and "The page assembler then pulls in the 
contents...." 

II) Exhibit A, page 43 (second paragraph) The 
Franklin Page Assembler expands a servable 
by including the contents of all included 
subfragments, and combines the resulting XML 

Wlin in© Out? \ji iiiuiw siyws oi levis uoiny 

LotusXSL to produce HTML output files. 

III) Exhibit E, page 3 (Executive Summary) ... 
Participants liked that Franklin: ... Provides the 
ability to change content once and have the 
changes appear in multiple places. 


chanae is made across one or more 


outDut oaaes concurrently bv 


automatically invokina an XSL 


transformation enaine so as to 


produce the outout Daaes. 



We, the undersigned, declare all of the above statements are made on our own 
knowledge, the above statements are true and correct, and the above statements are 
made on information that we believe to be true. We understand that false statements or 
concealment in obtaining a patent will subject us to fine and/or imprisonment or both (18 
U.S.C. §1001) and may jeopardize the validity of the above identified patent application 
or any application issuing therefrom. 



Peter E. DAVIS 
August , 2005 
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August , 2005 
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Louis WEIT2MAN 
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Overview 

Content on the Next Generation internet needs to be highly adaptive. New interfaces and devices 
are emerging, the diversity of users is increasing, machines are acting more and more on users' 
behalf, and net activities are possible for a wide range of business, leisure, education, and 
research activities. 

To achieve maximum flexibility and reuse, content needs to be broken down into richly tagged 
fragments that can be combined and rendered appropriately for the user, task, and context. The 
Franklin content management prototype builds on this premise. It provides an end-to-end process 
from content creation and meta-tagging to quality assurance and publishing. 

Franklin integrates several IBM technologies for its five components: content store, meta-data 
store, dispatcher, services and user interfaces. A high-level view of the components is shown in 
Figure 1 : Franklin Components. 
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Figure 1: Franklin Components 
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The content store builds upon the Daedalus (a.k.a Trigger Monitor) technology from IBM 
Watson Research. [For full specification, see 

http://w3.watson.ibmxom/-challngr/papers/daedalus/index.htrnl] Daedalus is designed to 
manage high numbers of rapidly changing content fragments. By maintaining an Object 
Dependency Graph, and by detecting changes to content, it manages pages on a web server or 
cached in a network router in a timely manner. 

The meta-data store manages tags that describe the functional and semantic role of each content 
fragment within the information collection. They may describe what the content is about, who 
the target audience is, and its relationship to a taxonomy or other fragments. The meta-data store 
also supports efficient searches. 

Networked services support the editor in content creation. They may assist the editor in meta- 
data creation, classification, summarization or translation. Instead of doing the task from 
beginning to end, the editor can accept, reject or modify the suggestions created by a service. 

The dispatcher's task is to delegate incoming requests to the content store, meta-data store and 
the services. The dispatcher presents a consistent application programming interface to the user 
interfaces. This Franklin API abides to the Web protocol for Distributed Authoring and 
Versioning (WebDAV) and to the Distributed Authoring Search Language (DASL) 
specification. 

The user interfaces communicate with the Franklin system through the API. Using the Editor UI, 
an editor can create and edit XML content fragments, upload XSL style sheets and multimedia 
objects, compose pages out of fragments, preview pages, review final published pages, and reject 
them or promote them to the final stage in the publishing flow. 

The Franklin system has also been integrated with KittyHawk, an IBM Notes based workflow 
engine. This workflow module can be turned on or off depending on the application needs. 

This document describes in detail the system requirements and setup, the architecture, 
components and features of Franklin. It covers the lessons learned, and provides a working 
example of a content collection managed with Franklin. In addition, it describes a lightweight 
version of Franklin, code-named Franklin Light, which satisfies the needs of small sites with no 
need for multiple Quality Assurance steps, or a scalable DB2 based search. 

System Setup & Configuration 

Before running an instance of Franklin to manage the content for a web site, you need to 
complete a number of installation steps. You also need to define the DTDs, the XSL style sheets, 
and the site map of the web site you intend to manage. This section outlines the required steps. 

Stepl: Install Franklin Server 

The Franklin Server runs on an AJX or NT server and requires the following software installed 
on the same machine: 

- Apache Web Server v. 1 .3.6 or higher 
WebSphere Application Server v.2.0 or higher 

- Java run-time environment 1.1.8 
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The Franklin server is distributed as ajar file, i.e., Franklin.jar. The distribution directory 

contains thefoljqwing jar files that are required bxFranklin: _xmJ4j jar, patbin 132 jar, _ _ ^ - j Deleted: 

daedalus.jar, lotusxsl.jar, xerces.jar. 

Download the Franklin Server and associated components from 

http://franklin.adtech.intemet.ibm.c^ and place them in a 

directory accessible by the WebSphere Application Server. 

Step 2: Install DB2 for Meta-Data Store 

The DB2 database used by the Meta-data Store can run on the same machine or a different 
machine. It requires the following software: 

1) DB2 6.1 with DB2 XML Extender 7.1 

Download DB2 XML Extenders 7.1 from IBM software website at 
http://www.software.ibm.com/db2 . Currently, XML Extenders is supported on Windows 
NT, AIX and Solaris. If you decide to use the XML Extender Administration Wizard 
make sure you review the XML Extender Administration Wizard Readme file to ensure 
you have the software prerequisites, JDK 1.1.x or JRE v 1.1.x and JFC 1.1 with Swing 1.1 
or later. 

2) JDBC forDB2 JDBC 1.20 

JDBC is included in the DB2 installation (db2java.zip) in the directory of sqllib/java. 

The steps to install DB2 and enable DB2 XML Extenders (which require root authority on AIX): 

1) Install a version of UDB higher than 5.2. We have tested DB2 XML on NT for UDB 5.2 
and 6. 1 , and on AIX for UDB 6. 1 for DB2 XML XColumn function. 

2) Create a DB2 instance. In the included examples, we use the db2 instance name db2frnkl. 

3) Install DB2 XML Extenders 

4) Create a database in the instance. Also, create the tables and indexes based on the sample 
scripts we have provided. 

5) Enable the database with XML Extenders 

6) Start JDBC on a port. For example, "db2jstrt 4000" opens port 4000 for JDBC 
connections. 

Step 3: Customize Server Initialization Files 

Edit franklinServletlnitialization.properties [file and set the following variable to the desired 
directory in your setup: 

baseDir - base directory for all Franklin related files. 



All other variables in franklinServletInitialization.properties are relative to baseDir and should 
not be changed: 

dtdDir - directory for DTD and entity files 

xmlDir - root of the directory hierarchy for XML files 



JcbmmehtiElWillshoiilf 

ItheipropeitiesiSesrdifferefltly 
| fr^linCSlientpropeities^ysf I 
^franxlinServeriproperties?; \£ 



assetsDir - directory for all directories browsable by client UI, i.e. xslDir, publishDir, 
multimediaDir 

xslDir - directory for XSL style sheets 

publishDir - root of the directory hierarchy for HTML, HDML or DHTML files 
multimediaDir - root of the directory hierarchy for images, graphics, video and audio 
files 

Edit metastore.ini file and set the following variables to the desired directory in your setup: 

MetaStoreServerIP - database host machine name 
MetaStoreServerPort - JDBC port number 
MetaStoreServerDBName - database name 
MetaStoreServerUserlD - database user name 
MetaStoreServerPassword - database password for the above user 
MetaStoreServerDriverClassName - database JDBC driver name 
MetaStoreServerlnitialConnection - number of initial connections to the database 
MetaStoreServerlncrement - number of additional connections to database 
MetaStoreChecklnXMLDir - temporary directory for XML files checked into meta store 
MetaStoreDADDir - directory for DAD files 

MetaStoreCacheSearchDir - directory for cached XML Search results 
Step 4: Configure WebSphere Application Server 

Start the WebSphere Administrative Console, refer to the WebSphere Quick Beginnings guide 
for details 

1 . In the Tasks tab of the console, select Configure a Web Application and click the start task 
button 

a. Specify the Web Application Name, e.g., FranklinServer, click Next. 

b. Choose the servlet engine, e.g., the ServletEngine in the Default Server of the Default 
Host, click Next 

c. Specify the Web Application Web Path, e.g., /franklinserver, click Next 

d. Specify the CLASSPATH: 

i. Add each of the jar files in the Franklin distribution to the classpath, i.e., franklinjar, 
daedalus.jar, xml4j jar, lotusxsl.jar, xerces.jar, patbinl32.zip 

ii. Add the db2java.zip file to the classpath, the db2java.zip file is distributed with DB2, 
it is found under the sqllib/java subdirectory of the database instance home directory 

iii. Click Finished 

2. In the same Tasks tab, select Add a Servlet and click the start task button 

a. Select Yes to "Do you want to select an existing Servlet jar file or Directory that contains 
Servlet classes" and click Next 

b. Specify the path of the directory where franklinjar is located, click Next 

c. Select the Web Application that was created in the previous step, click Next 

d. Select the Create User-Defined Servlet option, click Next 

e. Specify the Servlet Name, e.g., dispatcher 

f. Specify the Servlet Class Name as com.ibm.adtech.franklin.server.dispatcher.Dispatcher 
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g. Specify the Servlet Web Path List, for example /franklinserver/dispatcher, this is the web 
path that should be used by the client to access the franklin server, click next 

h. Add an init parameter with In it Parm Name as baseDir and Init Parm Value equal to the 
directory where the franklin server configuration files are stored, e.g., 
/franklin/data/config 

i. Select the True option for Load at Startup; click Finished 

3. The configuration is complete you need to start the service, select the Topology tab 

a. Prior to starting the application, make sure that the database instance is running and that 
jdbc daemon is active (see previous section) 

b. Expand the topology tree and select the newly created application. The application will 
appear under the servlet engine that was selected in step Lb 

c. Right click the selection and on the popup menu select Restart Application 

4. The Franklin Server should be available at this point. In order to verify that everything is in 
order view the log files of WebSphere 

Step 5: Install Franklin Client 

The Franklin Client Java Application has been tested on Windows98/2000/NT. 

Download the Franklin Client Application Installer FranklinEditor.exe from 
http://frariklin.adtech.intemet.ibmxonVfranklin/downloads/index.html and run it. In addition to 
the Franklin Client, the following Java packages are required and are automatically installed by 
the Installer: 

- Java 1.1.8 run-time environment with Swing JFC1 .1.1 

- XML4J package 

- WebDav package 

The Franklin Client Application Installer also creates the subdirectories required by the client 
under the chosen installation directory. You can change these directories as described in the next 
paragraph. 



After installation, customize the initialization file franklin.properties located in the root directory 
where you installed the Franklin Client application. You need to edit the variable browser Path to 

define the location of the web browser you wish to use to preview pages. Also, you can edit the 

variable tempDir if you wish to change the directory where temporary files are stored! „ - 4ie^mn§S2^^^Si^SSi3 

. names inHhe client propcrtoesfileuSt more: 

, 'Similar,to?tne:names:of ; the:vanablesm^ • 

dispatcher = http://adtech ibmus2. ibm. com/franklinservlet/ m^^M^^^^t^^B 



initXMLFile = xml/franklinJniLxml 

## modify browserPath to point to the web browser you wish to use for preview 
browserPath = c ./Program Files/Internet Explorer/iexplore.exe 

## modify tempDir to point to the directory where temporary files will be stored 

tempDir - Jtmp/ 

tempMediaDir = media/ 

tempHTMLDir = html/ 

tempXSLDir = xsU 

standaloneP = false 

validateP = true 
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Step 6: Define Document Type Definitions (DTD) 

Franklin manages two types of content objects, fragments and servables. 

A fragment is a content object that can be reused on several pages: 

- a simple fragment is a self contained XML file containing text data and metadata - for 
example, a product specification 

- a compound fragment is an XML file that contains metadata and points to an 
accompanying file such as a video or image file, an XSL style sheet, or a hand-crafted 
HTML page 

- an index fragment is an automatically updated XML file that indexes any number of 
servables - for example a panel listing the five latest press release [Future: index 
fragments not available in current implementation] 

A servable is an XML file that contains the text and meta-data for one final published page and 
imports reusable content from one or more fragments, and points to one of more style sheet 
fragments. 

Figure 2 shows a product page servable which includes content from six fragments, namely 
three text fragments, one image fragment and two style sheet fragments, and results in two final 
published pages. 

Insert Figure 2 here 

Before beginning to manage a content collection, you need to define the document type 
definitions, or DTDs, for each class of fragment and servable that will be managed by the 
application. Franklin uses the syntax of DTDs to define a document type. [See the XML 
specification at http://www.w3.org/TR/REC-xml] 

In order for Franklin to manage DTDs correctly, all DTDs must abide to the Franklin following 
specifications: 

Franklin specification of fragment and servable DTDs 

1. The root element, to which you can give a meaningful name, must have a child node called 
system with the children nodes fragmentid, creator, modifier, creationtime, 

LASTMODIFIEDTIME, PAGETYPE and CONTENTSIZE. The NAME attribute of PAGET YPE must be 

set to either "fragment" or "servable". 

<! ELEMENT ROOT (SYSTEM, ...)> 

<!ELEMENT SYSTEM (FRAGMENTID, 

C RE AT 1 0NT I ME , 
LASTMODIFIEDTIME, 
CREATOR, 
MODIFIER, 
PAGETYPE 
CONTENTSIZE?) > 
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<! ELEMENT FRAGMENT ID 

<! ELEMENT CREAT I ONT IME 

< ! ELEMENT LASTMODI FIEDTIME 

<! ELEMENT CREATOR 

<! ELEMENT MODIFIER 

< ! ELEMENT CONTENTS I ZE 

<! ELEMENT PAGETYPE 

< ! ATTLIST PAGETYPE 



(#PCDATA)> 
(#PCDATA)> 
(#PCDATA)> 
(# PCDATA )> 
(#PCDATA) > 
(# PCDATA) > 
{# PC DATA) > 

NAME ( FRAGMENT | SERVABLE ) 



"FRAGMENT" #FIXED> 



2. All items editable in the Editor UI need to be elements of the DTD, not attributes. For 
example, 



<! ELEMENT TITLE (#PCDATA)> 
< ! ELEMENT SHORTDESCRIPTION (#PCDATA)> 
<! ELEMENT CATEGORY (# PCDATA) > 



3. All elements to be indexed for search must be of type PCDATA, and must contain the 
attribute SEARCH set to YES. For example, 

<! ELEMENT ROOT (TITLE, SHORTDESCRIPTION, CATEGORY, ...) > 

<! ELEMENT TITLE (# PCDATA) > ■ 

< ! ELEMENT SHORTDESCRIPTION (#PCDATA)> 
<! ELEMENT CATEGORY (# PCDATA) > 

< ! ATTLIST TITLE SEARCH (YES|NO) "YES" #FIXED> 

<! ATTLIST SHORTDESCRIPTION SEARCH (YES | NO) "YES " #FIXED> 
<! ATTLIST CATEGORY SEARCH (YES | NO) "YES" #FIXED> 

Future: Need to add SEARCH attribute. The SEARCH attribute will allow Franklin to 
automatically generate the DAD mapping for the DB2 XML Extenders.. 



4. Include the external entity reference that defines the user interface widgets recognized by the 
Franklin Editor UI. Each element that needs to be editable in the Editor UI must be of type 
PCDATA and contain the DATATYPE attribute set to the appropriate UI type. 

< ! ENTITY % UITYPES SYSTEM 

"http: //f ranklinserver/franklin/dtd/uitypes . txt"> 

<! ATTLIST TITLE DATATYPE (%UITYPES;) "STRING" ' #FIXED> 

< "ATTLIST SHORTDESCRIPTION DATAYTPE (%UITYPES;) "LONGTEXT" #FIXED 

PARSE (TRUE) "TRUE" #FIXED> 

If you wish a LONGTEXT widget to allow an editor to enter a limited set of HTML tags, add the 
PARSE attribute and set it to true. The supported HTML are: 

<p>, <ul>, <ol>, <sl>, <dl>, <dt>, <dd>, <li>, <div> 

The file uitypes.txt is fixed and provided in the Franklin install in the dtdDir in the 
franklin.properties file. It contains the list of all UI widgets known to the Editor UI. (See section 
Editor UI Widgets for a detailed description of UITYPES) 

DATE | INTEGER | STRING ) SHORTTEXT | LONGTEXT | CHOICE | BROWSESERVER | 
BROWSELOCAL | ASSOCLIST 
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5. An element can appear as a drop-down menu in the Editor UI and restrict the editor to choose 
the value from a predefined set. To accomplish this, set the DATATYPE attribute to the 
UITYPE "CHOICE" and the CHOICES attribute to a default value from a list of options. The 
options can be defined as an external entity for reuse across many DTDs. 



<! ENTITY % CATEGORYDEFS SYSTEM 

"http : //f ranklinserver/f ranklin/dtd/categorydef s . txt"> ■ 

< ! ATTLIST CATEGORY DATATYPE (%UITYPES;) "CHOICE" #FIXED 

CHOICES (%CATEGORYDEFS; ) "NONE" #REQUIRED> 

For example, the options for category could be defined as the types of Netfinity servers: 

NONE | Netfinity_8500R I Netf inity_7000_M10 | Netf inity_5500_M10 | 
Netfinity_5600 I Netf inity_5500 

The Editor UI assumes that if the first word in the set of CHOICES is the string NONE, and the 
editor selects it, the element will not appear in the XML document. 

6. A fragment can include other fragments as subfragments. If so, the entity reference that 
defines all subfragment types must be included in the DTD. The declaration of a subfragment 
must contain the subfragmenttype attribute set to the appropriate type. 

< ! ENTITY % SUBFRAGMENTTYPES SYSTEM 

"http: //f ranklinserver/f ran klin/dtd/subf ragmenttypes . txt"> 
<! ELEMENT SUBFRAGMENT (# PCDATA) > 

<! ATTLIST SUBFRAGMENT SUBFRAGMENTTYPE (% SUBFRAGMENTTYPES ; ) "I MAGE FRAGMENT" 
#FIXED> 

Future: the subfragment syntax will be replaced by the XLink syntax once it becomes a W3 
recommendation and XML4J and LotusXSL support the syntax. Until then, we will use 
subfragment elements as way to include content from another fragment. 



An example of a fragment DTD, listfragment.dtd: 



<! ENTITY % SUBFRAGMENTTYPES SYSTEM 

"http: //f ranklinserver/f ranklin/dtd/subf ragmenttypes. txt"> 
<! ENTITY % CATEGORYDEFS SYSTEM 

"http: //f ranklinserver/f ranklin/dtd/categorydef s . txt"> 
<! ENTITY % UITYPES SYSTEM 

"http: //f ranklinserver/f ranklin/dtd/uitypes . txt"> 



<! ELEMENT LISTFRAGMENT 



<! ELEMENT SYSTEM 



< ! ELEMENT 
< ! ELEMENT 
< ! ELEMENT 
< ! ELEMENT 
< ! ELEMENT 
< ! ELEMENT 
< ! ELEMENT 
< ! ELEMENT 
< ! ELEMENT 



FRAGMENT ID 
CREATIONTIME 
L AS TMOD IFIEDTIME 
CONTENTS I ZE 
CREATOR 
MODIFIER 
PAGETYPE 
TITLE 

SHORTDESCRIPTION 



(SYSTEM, TITLE, SHORTDESCRIPTION?, CATEGORY*, 
LISTITEM+) > 

(FRAGMENTID, CREATOR, MODIFIER, CREATIONTIME, 
LASTMODIFIEDTIME, PAGETYPE, CONTENTSIZE?) > 
(# PCDATA) > 
(# PCDATA) > 
(# PCDATA) > 
(# PCDATA) > 
(# PC DATA) > 
(# PCDATA) > 
{# PCDATA) > 
(# PCDATA )> 
(# PCDATA) > 
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< ! ELEMENT 


CATEGORY 


(# PCDATA) > 




< ! ELEMENT 


LISTITEM 


(LISTTITLE?, DESCRIPTION?, LINK?, 


FOOTNOTE? )> 


< ! ELEMENT 


LISTTITLE 


(# PCDATA) > 




< ! ELEMENT 


DESCRIPTION 


{# PCDATA) > 




< ! ELEMENT 


LINK 


(# PCDATA) > 




< ! ELEMENT 


FOOTNOTE 


(# PCDATA )> 




< ! ATTLIST 


TITLE 


DATATYPE (%UITYPES;) #FIXED 


"STRING" 






SEARCH (YES | NO) "YES" #FIXED> 





<! ATTLIST 

<! ATTLIST CATEGORY 



<! ATTLIST 
<! ATTLIST 
<! ATTLIST 
< 'ATTLIST 



SHORTDESCRIPTION DATATYPE (%UITYPES;) #FIXED 
SEARCH {YES | NO) "YES" #FIXED> 

DATATYPE {%UITYPES; ) #FIXED 
CHOICES (%CATEGORYDEFS; ) #IMPLIED 
SEARCH (YES|NO) "YES" #FIXED> 
LISTTITLE DATATYPE (%UITYPES;) #FIXED 

DESCRIPTION DATATYPE (%UITYPES/) #FIXED 

LINK DATATYPE (%UITYPES;) #FIXED 

FOOTNOTE DATATYPE (%UITYPES;) #FIXED 



"SHORT TEXT" 



"CHOICE" 



,f STRING "> 
" STRING "> 
"STRING"> 
*STRING"> 



Franklin specification of compound fragment DTDs 

A compound fragment contains a pointer to an accompanying file, such as a multimedia file, an 
XSL style sheet or a hand-crafted HTML file (i.e. ones that are not generated from XML by 
Franklin) The accompanying file is encoded as a binary object into the fragment for the duration 
of the communication between Editor UI and Franklin Server, Before check-in to the server, the 
Editor UI encodes the file as a binary object into the XML fragment. At the receiving end, the 
dispatcher extracts it and decodes into the original format. The reverse happens at check-out. 
This allows a single communication between the client and server when exchanging this type of 
fragments. 

1 . A compound fragment DTD must use the following syntax to declare the inclusion of an 
external file: 

<! ELEMENT CONTENT (# PCDATA) > 

<! ELEMENT CONTENTDIR (#PCDATA)> 

<! ELEMENT CONTENT FILENAME (# PCDATA) > 

<! ATTLIST CONTENT DATATYPE (%UITYPES;) #FIXED "STRING"> 

<! ATTLIST CONTENTDIR DATATYPE (%UITYPES;) #FIXED "BROWSESERVER"> 

< ! ATTLIST CONTENT FILENAME DATATYPE (%UITYPES;) #FIXED "BROWS EL OCAL"> 



Franklin specification of group index fragment DTDs 

Future: To be filled in 

Franklin specification of servable DTDs 

In the Franklin system, servables always result in one of more final published pages. The DTD 
must indicate the names of the XSL style sheets it can use for layout and where to publish the 
resulting pages. 
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1. A servable DTD must contain the following declarations: 



< ! ELEMENT PUBLISHINFO (STYLESHEET, PUBLISHDIR, PUBLISHFILENAME) > 

< ! ELEMENT STYLESHEET {# PCDATA) > 

<! ELEMENT PUBLISHDIR (#PCDATA)> 
< ! ELEMENT PUBLISHFILENAME (#PCDATA)> 

< ! ATTLIST STYLESHEET DATATYPE (%UITYPES;) #FIXED "CHOICE" 

CHOICES (styleshheetl .xsl | stylesheet2 .xsl) #IMPLIED> 
< ! ATTLIST PUBLISHDIR DATATYPE (%UITYPES;) #FIXED " BROWSE SERVER"> 

< ! ATTLIST PUBLISHFILENAME DATATYPE (%UITYPES;) #FIXED "STRING"> 

2. A servable can include one or more subfragments. Each subfragment serves a specific role 
within the servable and can be named in a meaningful way, for example MAINPHOTO, 
HIGHLIGHTS etc. Each subfragment must have an attribute that indicates the type of 
subfragment to include. The syntax to include a subfragment in a servable follows: 



<! ELEMENT MAINPHOTO (#PCDATA)> 
<! ELEMENT HIGHLIGHTS (#PCDATA)> 
<! ATTLIST MAINPHOTO DATATYPE (%UITYPES;) 

SUBFRAGMENTTYPE (% SUBFRAGMENT TYPES ; ) 
<! ATTLIST HIGHLIGHTS DATATYPE (%UITYPES;) 

SUBFRAGMENTTYPE (%SUBFRAGMENTTYPES ; ) 



#FIXED "STRING" 
# FIXED "IMAGE FRAGMENT "> 
#FIXED "STRING" 
# FIXED "LI STFRAGMENT " > 



3. A servable can be included in an automatically generated group index fragment. 
To be filled in 



An example of a servable DTD, productpage.dtd: 

<! ENTITY % UNIVERSAL SYSTEM 

"http: //f ranklinserver/f ranklin/dtd/universal .dtd"> 
<! ENTITY % SUBFRAGMENTTYPES SYSTEM 

"http : //f ranklinserver/f ranklin/dtd/subf ragmenttypes . txt"> 
<! ENTITY % CATEGORYDEFS SYSTEM 

"http : //f ranklinserver/f ranklin/dtd/categorydefs . txt"> 

< ! ELEMENT PRODUCT PAGE (SYSTEM, TITLE, SOURCE? , COMMENT?, SHORTDESCRIPTION 
LONGDESCRIPTION?, KEYWORD* , CATEGORY*, RELATEDLINK* , 
PUBLISHINFO+, BRANDNAVIGATION, MAINPHOTO, GLANCE, 
HIGHLIGHTS , GROUPINDEX* ) > 
<! ELEMENT SYSTEM (FRAGMENTID, CREATOR, MODIFIER, C RE AT I ONT I ME , 

LASTMODI FI EDT IME , PAGETYPE, CONTENTS I ZE? ) > 
<! ELEMENT FRAGMENTID (# PCDATA )> 

<! ELEMENT CREATIONTIME (# PCDATA )> 

< ! ELEMENT LASTMODI FI EDT IME (#PCDATA)> 

(# PCDATA )> 
(# PCDATA )> 
(# PCDATA )> 
{# PC DATA) > 
(# PCDATA) > 
(# PC DATA) > 
(# PCDATA )> 
(# PCDATA) > 
(# PCDATA) > 
(# PCDATA) > 



< ! ELEMENT CONTENT S 1 2 E 

<! ELEMENT CREATOR 

< ! ELEMENT MODIFIER 

<! ELEMENT PAGETYPE 

< ! ELEMENT TITLE 

<! ELEMENT SOURCE 

<! ELEMENT COMMENT 

< ! ELEMENT SHORTDESCRI PT ION 

< ! ELEMENT LONGDESCRIPTION 

<! ELEMENT KEYWORD 



< 


! ELEMENT 


CATEGORY 


(# PCDATA) > 


< 


! ELEMENT 


RELATEDLINK 


(URL, LINKTITLE )> 


< 


! ELEMENT 


URL 


(# PCDATA) > 


< 


! ELEMENT 


LINKTITLE 


(# PCDATA )> 


< 


. ELEMENT 


DOCTYPE 


(#PCDATA)> 


< 


. ELEMENT 


DTDURL 


(#PCDATA)> 


< 


. ELEMENT 


PUBLISHINFO (STYLESHEET, PUBLISHDIR, 


< 


ELEMENT 


STYLESHEET 


(# PCDATA) > 


< 


ELEMENT 


PUBLISHDIR 


(# PCDATA )> 


< 


ELEMENT 


PUBLISHFILENAME 


(#PCDATA)> 


< 


ELEMENT 


B RAN DNA V I GAT I ON 


(# PCDATA) > 


< 


ELEMENT 


MAINPHOTO 


(# PCDATA) > 


< 


ELEMENT 


GLANCE 


(#PCDATA)> 


< 


ELEMENT 


HIGHLIGHTS 


(# PCDATA) > 


< 


ELEMENT 


GROUPINDEX 


(# PCDATA) > 


< 


ATTLIST . 


TITLE 


DATATYPE (%UITYPES;) 


< 


ATTLIST 


SOURCE 


DATATYPE (%UITYPES;) 


< 


ATTLIST 


COMMENT 


DATATYPE (%UITYPES;) 


< 


ATTLIST 


SHORTDESCRIPTION 


DATATYPE (%UITYPES;) 


< 


ATTLIST 


LONGDESCRIPTION 


DATATYPE (%UITYPES;) 


"SHORTTEXT n > 





PUBLISHFILENAME) > 



#FIXED 
#FIXED 

FIXED 

#FIXED 
#FIXED 



"STRING"> 
"STRING"> 
"STRING"> 
"SHORTTEXT " > 



<! ATTLIST KEYWORD 
<! ATTLIST CATEGORY 



DATATYPE (%UITYPES;) 
DATATYPE (%UITYPES;) 

( %CATEGORYDEFS 
DATATYPE (%UITYPES;) 
■DATATYPE (%UITYPES;) 
DATATYPE (%UITYPES;) 



CHOICES 

<! ATTLIST URL 
<! ATTLIST LINKTITLE 
<! ATTLIST BRANDNAVIGATION 

SUBFRAGMENTT YPE ( % SUBFRAGMENTT YPES ; ) 
<! ATTLIST MAINPHOTO DATATYPE (%UITYPES;) 

SUBFRAGMENTT YPE ( % SUBFRAGMENTT YPES ; ) 
< ! ATTLIST GLANCE DATATYPE (%UITYPES;) 

SUBFRAGMENTTYPE (% SUBFRAGMENTT YPES ; ) 
< ! ATTLIST HIGHLIGHTS DATATYPE (%UITYPES;) 

SUBFRAGMENTTYPE (% SUBFRAGMENTT YPES ; ) 
<! ATTLIST STYLESHEET DATATYPE (%UITYPES;) 

CHOICES (web_product_index.xsl | pda_product_index . xsl) 
#IMPLIED> 

<! ATTLIST PUBLISHDIR DATATYPE (%UITYPES;) 
< ! ATTLIST PUBLISHFILENAME DATATYPE (%UIT YPES; ) 
< ! ATTLIST GROUPINDEX DATATYPE (%UITYPES; ) 

SUBFRAGMENTTYPE ( % SUBFRAGMENTT YPES ; ) 



#FIXED "STRING"> 
#FIXED ' "CHOICE" 

#IMPLIED> 

#FIXED "STRING"> 
#FIXED "STRING"> 
#FIXED "STRING" 
#FIXED LISTFRAGMENT" 

#FIXED "STRING" 
#FIXED "IMAGE FRAGMENT "> 

#FIXED "STRING" 
#FIXED "LI ST FRAGMENT " > 
#FIXED "STRING" 
#FIXED "LIST FRAGMENT " > 
#FIXED "CHOICE" 



#FIXED "BROWSESERVER"> 
#FIXED "STRING"> 
#FIXED "STRING" 
#FIXED "GROUPINDEX"> 



An example of a servable, 2-tsrv.xml, which abides to productpage.dtd: 

<?xml version="l. 0"?> 

<! DOCTYPE PRODUCT PAGE SYSTEM "http : //f ranklinserver /dtd/productpage . dtd"> 
<PRODUCTPAGE> 
<SYSTEM> 

< FRAGMENT I D> 2 - 1 s rv . xml < / FRAGMENT I D> 
<CREATOR>Joe Mo e < / C REAT OR> 
<MODIFIER> Jane Mane</MODIFIER> 
<CREATIONTIME>384738740383</CREATIONTIME> 
<LASTMODIFIEDTIME>384738740383</LASTMODIFIEDTIME> 
<PAGETYPE>Servable</PAGETYPE> 
</SYSTEM> 

<TITLE>Netfinity 8500R</TITLE> 
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<SOURCE>IBM PC Company</SOURCE> 

<SHORTDESCRIPTION>Mainf rame features bring extraordinary performance and 
reliability to a rack-optimized 8-way server</SHORTDESCRIPTION> 

<LONGDESCRIPTION>A great value in 8-way servers, the new Netfinity 8500R 
maximizes uptime and provides superior manageability for compute-intensive 
business intelligence, transaction processing and server consolidation 
projects. </LONGDESCRIPTION> 

<KE YWORD>New< /KEYWORD> 

<KEYWORD>Server</KEYWORD> 

<KE YWORD> Pen t i um< / KE YWORD> 

<CATEGORY>Netfinity 8500R</CATEGORY> 

<CATEGORY>Small and Medium Business</CATEGORY> 

<RELATEDLINK> 

<URL>f tp : //ftp . pc . ibm. com/pub /pccbbs /pc_servers/8500rf . pdf </URL> 
<LINKTITLE>White paper</LINKTITLE> 
</ RELATE DLINK> 
<PUBLISHINFO> 

<PUBLISHDIR>/web/netfinity/</PUBLISHDIR> 
<PUBLI SHFILENAME>index . html</PUBLISHFILENAME> 
<STYLESHEET>web_product_index . xsl</STYLESHEET> 
</PUBLISHINFO> 
<PUBLISHINFO> 

<PUBLISHDIR>/pda/netfinity/</PUBLISHDIR> 
<PUBLI SHFILENAME>index . htrnK /PUBLI SHFILENAME> 
<STYLESHEET>pda_prpduct_index . xsl</STYLESHEET> 
</PUBLISHINFO> 

<GROUPINDEX>4 4 4-ifrg.xml</GROUPINDEX> 
<MAINPHOTO SUBFRAGMENTTYPE= " I MAGE FRAGMENT" > 

222-bfrg.xml</MAINPHOTO> 
<HIGHLIGHTS SUBFRAGMENTTYPE="LISTFRAGMENT"> 

444-tfrg.xml</HIGHLIGHTS> 
</PRODUCTPAGE> 

Once all DTDs for the collection have been defined, save them in the directory defined by the 
variable dtdDir in the franklin.properties file. 

After updating, adding or deleting any DTDs, update the files configDir/dtds.xml and 
dtdDir/subfragmenttypes.txt to reflect the current DTDs. Also remember to define a DAD file to 
for each DTD. (Future: DAD explanation should be expanded) 



Step 7: Define Style Sheets 

For each servable DTD, you need to define one or more XSL style sheets that will be assembled 
with the servable XML and the XML of any subfragments into the final published pages. A style 
sheet is written using the XSL syntax to produce HTML, DHTML, HDML or other desired 
output. [See the XSL Transformations syntax at http://www.w3 .org/TRyjSjtf] 

Franklin specification of XSL style sheets 

Because the servable includes content from subfragments, the style sheet must be written to work 
on the so-called expanded servable. Before page assembly, a servable is temporarily rewritten to 
include the content of all its subfragments. Because the XLink standard has not been finalized, 
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XSL style sheets cannot access content stored in subfragment files outside the servable. Franklin 
implements a temporary solution that mimics the XLink functionality by expanding the servable. 
This is demonstrated by the expanded product page 2-tsrv.xmI: 

<?xml version="l .0"?> 
<!DOCTYPE PRODUCTPAGE SYSTEM 

"http : //your f ranklinserver /dtd/productpage . dtd"> 
<PRODUCTPAGE> 
<SYSTEM> 

< FRAGMENT ID>2-tsrv. xml < / FRAGMENT I D> 
<CREATOR>Joe Moe</CREATOR> 
<MODIFIER>Jane Mane</MODIFIER> 
<CREATIONTIME>384738740383</CREATIONTIME> 
<LASTMODIFIEDTIME>384738740383</LASTMODIFIEDTIME> 
<PAGETYPE>Servable</PAGETYPE> 
</SYSTEM> 

<TITLE>Netfinity 850OR</TITLE> 
<SOURCE>IBM PC Company</SOURCE> 

<SHORTDESCRI PTION>Mainf rame features bring extraordinary performance and 
reliability to a rack-optimized 8-way server</SHORTDESCRIPTION> 

<LONGDESCRIPTION>A great value in 8-way servers, the new Netfinity 8500R 
maximizes uptime and provides superior manageability for compute-intensive 
business intelligence, transaction processing and server consolidation 
projects. </LONGDESCRIPTION> 

<KEYWORD>New< /KEYWORD> 

<KEYWORD>Server</KEYWORD> 

<KEYWORD>Pentium</KEYWORD> 

<CATEGORY>Netf inity 8 5 0 0R< /CATEGORY> 

<CATEGORY>Small and Medium Bus ine s s < /CATEGORY> 

<RELATEDLINK> 

<URL>ftp: //ftp.pc. ibm.com/pub/pccbbs/pc_servers/8500rf .pdf</URL> 
<LINKTITLE>White paper</LINKTITLE> 
</RELATEDLINK> 
<PUBLISHINFO> 

<PUBLISHDIR>/web/netfinity/</PUBLISHDIR> 
<PUBLISHFILENAME>index.html</PUBLISHFILENAME> 
<STYLESHEET>web_product_index . xsl</STYLESHEET> 
</PUBLISHINFO> 
<PUBLISHINFO> 

<PUBLISHDIR>/pda/netfinity/</PUBLISHDIR> 
<PUBLISHFILENAME>index . html< /PUBLI SHFILENAME> 
<ST YLESHEET>pda_pr oduct_index . xsl< /STYLESHEET> 
</PUBLISHINFO> 

<GROUPINDEX>444-ifrg.xml</GROUPINDEX> 
<MAINPHOTO S UB FRAGMENT TY P E= " I MAGE FRAGMENT " > 
< IMAGE FRAGMENT > 
<SYSTEM> 

<FRAGMENTID>2 2 2 -bfrg . xml</ FRAGMENT ID> 
<CREATOR>BOB</ CREATOR> 
<MOD IFIER>BOB</MODIFIER> 

<CREATIONTIME>3 8 4 7 3 8 7 4 03 8 3< / CREATIONT IME> 
<LASTMOD IFIEDTIME>3 8 4 7 3 8 7 4 0 3 8 3< /LASTMODIFIEDTIME> 
<PAGETYPE>Fragmen t< / PAGET YPE> 
<CONTENTSI ZE>4 0 0</ CONTENTS 1 2E> 
</SYSTEM> 

<TITLE>The Netfinity 850 OR large jpeg</TITLE> 
<SHORTDESCRIPTION>Netf inity 8500R</SHORTDESCRIPTION> 
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< CONTENTD I R> / image s /pr od_image s /< / CONTENTD I R> 
< CONTENTF IU3NAME>8 5 0 0R_1 ar ge . jpg</CONTENTFILENAME> 
<CONTENT/> 
< / IMAGE FRAGMENT> 

</MAINPH0TO> 

<HI GHLIGHT S SUB FRAGMENTT Y PE= " L I ST FRAGMENT " > 
<LISTFRAGMENT> 
<SYSTEM> 

<FRAGMENT ID> 4 4 4 - tf r g . xml< / FRAGMENT ID> 
<CREATOR>BOB< /CREATOR> 
<MODIFIER>BOB</MODIFIER> 

<CREATIONTIME>384738740383</CREATIONTIME> 
<PAGETYPE>Fragment</PAGETYPE> 

<LASTMODIFIEDTIME>384738740383</IASTMODIFIEDTIME> 
</SYSTEM> 

<TITLE>Highlights of the 8500R</TITLE> 
<CATEGORY>Netfinity 8500R</CATEGORY> 
<LISTITEM> 

<TITLE>Light-Path Diagnostics</TITLE> 
<BODY>Lighted guidance system to assist in quick 
identification of failing components, similar to the lights in a copier 
that identify the location of a paper jam.</BODY> 
</LISTITEM> 
<LISTITEM> 

< T I TLE >Ac t i ve PCI technology</TITLE> 
<BODY>Enables IBM's unique hot-add PCI, letting you 
add client systems, balance network traffic or increase storage capacity 
without shutting the system down. </BODY> 
</LISTITEM> 
</LISTFRAGMENT> 
</HIGHLIGHTS> 
</PRODUCTPAGE> 

Any Xpath expressions in the style sheet that refer to subfragment content will be local to the 
servable. The following example XSL style sheet, webjroducMndex.xsl, produces a simple 
HTML page by displaying content form the servable as well as the two subfragments: 

<?xml version="l . 0"?> 

<xsl: stylesheet xmlns : xsl="http : //www. w3 . org/XSL/Trans form/1 . 0"> 



<xsl: template match="PRODUCTPAGE"> 

<HTML> 

<HEAD> 

<TITLE><xsl : value-of select=" TITLE" /></TITLE> 

<META NAME="source-xml" CONTENT-" { SYSTEM/FRAGMENTID} "/> 

<META NAME="source-xsl" CONTENT="web_product_index . xsl "/> 

</HEAD> 

<BODY> 

< TABLE CELLPADDING= "0 " CELLSPACING="0" B0RDER= " 0 " WIDTH=" 45 1 "> 

<TR> 

<TD> 

<! — title section — > 

<F0NT COLOR="#003399" SIZE="+3" FACE=" Times New Roman"> 

<xsl :value-of select="TITLE"/> 

</FONTXBR/XBR/> 
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<! — end title section — > 

<! — short description section — > 

<BXFONT SIZE="-1" FACE= "Arial "> 

<xsl:value-of select="SH0RTDESCRIPTI0N , 7> 

</FONTXBR/XBR/X/B> 
<! — end short description section --> 
</TD> 
</TR> 
<TR> 
<TD> 

<! — photo section — > 

<IMG HEIGHT="110" WIDTH="140" 
SRC=" /multimedia { MAI NPHOTO/IMAGEFRAGMENT/ CONTENT DIR} { MAIN PHOTO /IMAGEFRAGMEN 
T/CONTENTFILENAME} " BORDER= "0 " 

ALT= "MAINPHOTO/ IMAGE FRAGMENT/ SHORTDESCRI PT ION " >< / IMG> 

<! — end of photo section --> 

</TD> 

</TR> 

</TABLE> 

<! — Highlights section — > 

< TABLE BORDER= " 0 " CELLSPACING="0 " CELLPADDING=" 5 " WIDTH="451"> 
<TR> 

<TD COLSPAN="2" WIDTH="451"> 

<B><FONT SIZE="-1" FACE= "Arial ">Highlights of the 

<xsl:value-of select="TITLE"/> 

</FONTX/B> 
</TD> 
</TR> 

<xsl :apply-templates select="HIGHLIGHTS/LISTFRAGMENT/LIST"/> 
</TABLE> 

<!-- End of Highlights section — > 

</BODY> 

</HTML> 

</xsl : template> 



<xsl : template match— "/PRODUCT PAGE /HI GHLIGHTS/L I STFRAGMENT"> 
<xsl : f or-each select:="LISTITEM"> 
<TR> 

<TD WIDTH="151" VALIGN="TOP"> 

<FONT size="-l" face="Arial"xxsl:value-of select="TITLE"/x/FONT> 
</TD> 

<TD WIDTH="300" VALIGN="TOP n > 

<FONT size="-l" f ace="Arial"><xsl : value-of select="BODY"/x/FONT> 

</TD> 

</TR> 
</xsl : for-each> 
</xsl : template> 
</xsl : stylesheet> 



Once all XSL style sheets for the DTDs have been defined, add them to the CHOICES list of the 
STYLESHEET element in the appropriate DTDs. 



Then, check them in to the /xsl directory using the Franklin Editor. 
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[Add here, the definition of a debug style sheet, what is should do, and where it should be saved 
on the server] 

Step 8: Create Directory Structure 

Create the directory structure that corresponds to the site map of your application. Under 
publishDir create the HTML directories, and under multimediaDir the multimedia directories. 

If your site is published to more than one audience segment or device, define several sibling 
directory structures under publishDir. For example, a site published for two devices, one for 
browsing all content using a web browser, and another for browsing only the news section using 
a pda browser, could have the following directory structure: 

publishDir/web/ 

publishDir/web/news/ 

publishDir/web/products/ 

publishDir/pda/ 

publishDir/pda/news/ 

multimediaDir/images/ 

multimediaDir/ audio/ 

When an editor authors a servable, the PUBLISHDIR element of the servable will be presented 
in the UI with the BROWSESERVER widget. This widget allows the editor to browse the 
directory structure under assetsDir and select where to save the resulting file. Similarly, when 
editing a multimedia object, the widget allows the editor to browse the directory structure to 
select where to save the binary file. 

Step 9: Configure Web Server 

To browse the published sites, set up a web server for each sibling site. Configure the Document 
Root variable to point to the top of the directory hierarchy of a sibling site. The example below 
assumes that the baseDir in franklinServletlnitialization.properties is set to "/franklin/data/": 

For the example in the previous section, you would set up two web servers: 

Web Server 1: Document Root "/franklin/data/publish/web/" 
Web Server 2: DocumentRoot "/f ranklin/data/publish/pda/" 

Also, add the aliases below to the configuration file of Web Server 1 and 2. 

Alias /dtd/ Vfranklin/data/dtd/" 

Alias /xsl/ Vf ranklin/data/assets/xsl/" 

Alias /multimedia/ "/franklin/data/assets/multimedia/'' 

Alias /xml/ "/f ranklin/data/xml" 

Set directory browsing "on" so that you can easily browse the DTDs and verify the uploaded 
XML files, XSL style sheets, and multimedia files. 
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Step 10: Define Roles & Users 

Before running the Editor UI, you need to define the allowed roles and users of the Franklin 
system. A role is defined by the list of DTDs the role is allowed to edit. A user is defined by one 
or more roles. 

To define new roles, edit the file configDir/roles.xml by importing the DTD configDir/roles.dtd 
to an XML editor such as Xeena from IBM alphaworks. (Future: use the Editor UI to edit the 
file) 

The DTD roles. did: 



<! ELEMENT ROLES (ROLE*)> 

■ < ! ELEMENT ROLE ( ROLENAME , DTD* ) > 

<! ELEMENT ROLENAME (#PCDATA)> 

<! ELEMENT DTD {#PCDATA)> 



An example roles.xml defines two roles, FragmentEditor and Editor and associates the allowed 
DTDs to each: 

<?xml version="l . 0" encoding="UTF-8"?> 
<ROLES> 

<ROLE> 

< ROL EN AME > Fr a gme n t E di t o r < / ROLENAME > 

<DTD>http : //franklinserver/dtd/textf ragment . dtd</DTD> 
<DTD>http : //franklinserver/dtd/listf ragment . dtd</DTD> 
<DTD>http : //franklinserver/dtd/audiof ragment . dtd</DTD> 
<DTD>http : //f ranklinserver/dtd/videof ragment . dtd</DTD> 
<DTD>http : //franklinserver/dtd/imagef ragment . dtd</DTD> 

</ROLE> 

<ROLE> 

<ROLENAME>Edi tor < / ROLENAME> 

<DTD>http : //franklinserver/dtd/textf ragment . dtd</DTD> 
<DTD>http: //franklinserver/dtd/newsarticle.dtd</DTD> 
<DTD>http : //f ranklinserver/dtd/productpage . dtd</DTD> 
</ROLE> 
</ROLES> 

To define new users, edit the file configDirlusers.xml by importing the DTD configDir/users.dtd 
to an XML editor. 

The DTD users.dtd: 

<! ELEMENT USERS (USER*)> 

<! ELEMENT USER (NAME, EMAIL, PASSWORD, ROLE+) > 

<! ELEMENT NAME (#PCDATA)> 

<! ELEMENT EMAIL (#PCDATA)> 

<! ELEMENT PASSWORD (#PCDATA)> 

<! ELEMENT ROLE (# PCDATA) > 

An example users.xml defines two users, each with one or more roles. 

<?xml version="l . 0" encoding="UTF-8" ?> 
<USERS> 
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<USER> 
<NAME>Joe Moe</NAME> 
<EMAIL>joe@us .ibm. com</EMAIL> 
<PASSWORD> j oe</PASSWORD> 
<ROLE>FragmentEditor</ROLE> 
<ROLE>Editor</ROLE> 

</USER> 
<USER> 
< NAME > Jane Mane</NAME> 
<EMAIL>jane@us .ibm. com</EMAIL> 
< PAS SWORD >jane</PAS SWORD> 
<R0LE>Editor</ROLE> 
</USER> 
<USER> 
</USERS> 

When the Franklin server is initialized, the Dispatcher module runs GlobalsJoadinfoO. This 
method merges users.xml, roles.xml and dtds.xml into one DOM in memory for fast access. The 
method verifies that all roles named in users.xml have a definition in roles.xml. It also verifies 
that all DTDs named in roles.xml are defined in dtds.xml and exist in the named directory. If any 
discrepancies are detected, the server prints out a warning message. (Future: the verification still 
needs to be implemented.) 

(Future: if any of the configuration files have changed after the server was last initialized, the 
files will get reloaded and the DOM will get refreshed. This will not have an effect on any users 
currently logged on.) 

Editor Interface & Dispatcher Communication 

After installing the Editor User Interface application and completing the customization described 
in Section Install Franklin Client, launch the application from the Franklin Editor icon on the 
desktop. 

All communications between the Editor UI and the Franklin Dispatcher follow the WebDAV 
protocol. [See the full specification at http://www.webdav.org/specs/] 

The HTTP header of a Client request always contains the following attributes with ACTION 
replaced by PUT, GET, LOCK or VNLOCKJranklinservername replaced by the name of the 
Franklin server the client is communicating with, and length replaced by the length in bytes of 
the body section. 

ACTION /filename HTTP/1.1 
Host: franklinservername 
Content-type: text/xml; charset="utf-8 " 
Content-Length: length 

The body of the Client request contains the XML document to be checked into the server or a 
DASL search query. 

The HTTP header of the Dispatcher response always contains the following attributes with 
errorcode and message replaced by the standard codes listed in Appendix 1 . 
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HTTP/1.1 errorcode message 
Content-Type: text/xml; charset= 
Content-Length: length 



"utf-8 1 



The format of the body of the Dispatcher response depends on the request and whether the 
| request was successfully completed or not. 

A special format used for the response follows the DTD below. In the further examples, the use 
of me elements will become obvious. 



<! ELEMENT RESPONSE (PROCESS, 
<! ELEMENT PROCESS 
<! ELEMENT STATUS 
<! ELEMENT ERRORCODE 
<! ELEMENT MESSAGE 
<! ELEMENT SYSTEM 
LASTMODIFIEDTIME, PAGET YPE, 
<! ELEMENT FRAGMENT ID 

<! ELEMENT CREATOR (.# PCDATA ) > 

<! ELEMENT MODIFIER (#PCDATA)> 

<! ELEMENT CREATIONTIME (#PCDATA)> 

<! ELEMENT LASTMODIFIEDTIME {#PCDATA)> 

< ! ELEMENT PAGETYPE (# PCDATA) > 

< ! ELEMENT CONTENTSIZE (#PCDATA)> 
<! ELEMENT LOCK (LOCKEDBY, 

< ! ELEMENT LOCKEDBY ( # PCDATA ) > 
< ! ELEMENT LOCKT IME ( # PCDATA ) > 
<! ELEMENT LOCKTOKEN <#PCDATA)> 



STATUS, ERRORCODE, MESSAGE, SYSTEM? , LOCK?)> 
(#PCDATA)> 
(# PC DATA) > 
{# PCDATA) > 
(#PCDATA)> 

(FRAGMENTID, CREATOR, MODIFIER, CREATIONTIME, 
CONTENTSIZE?) > 
(# PC DATA) > 



LOCKTIME, LOCKTOKEN?) > 



Login 

The editor logs in using the user name and password defined by the Franklin administrator, as 
defined in Section Define Roles & Users. 



Client request: 



GET /xml/franklin_init.xml HTTP1 . 1 
Host: franklinse rver/ franklins ervlet 
Content-Type: text/xml; charset="utf-8" 



Authorization: "Basic " + encode Base64 {username + ":" + password) 



If the user name is not defined or if the password is entered incorrectly, the dispatcher responds 
with the appropriate error. Dispatcher response: 

HTTP/1.1 401 SC__UNAUTHORIZED 
Content-Type: text/xml; charset-"utf -8 " 
Content-Length: length 

<?xml version="l. 0"?> 
<RESP0NSE> 

<PROCESS>login</PROCESS> 

<STATUS>4 01|</STATUS> 



Comment [ LW4]: I don't think.this is * 
• the nghterror code returned here; But ' t 
jcouldn^t.tell cus'itsnot^woiking. ^ } ; 
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<ERRORCODE>U10K/ERRORCODE> 

<MESSAGE>User Joe Doe not def ined</MESSAGE> 
</RESPONSE> 

If login succeeds, as described in Section Dispatcher: Session Management, the Dispatcher adds 
the user to the currentusers hash table and generates a unique session identifier, sessionld. All 
subsequent requests from the Editor UI must contain sessionld in the HTTP header. 

The dispatcher responds to a successful login request by generating the franklin Jnitxml 
document that corresponds to the user's roles, references the DTDs the user is allowed to edit, 
and specifies the attributes, operators and allowed values for the Search UI. Dispatcher response: 

HTTP/1.1 200 OK 

Content-Type: text/xml; charset="utf -8 " 
Content-Length: length 
Sessionid: 175a : dc8e0de306 : -8000 

<?xml version="l. 0" encoding="UTF-8" ?> 
<FRANKLIN__INIT> 
<SEARCH> 

<ATTRIBUTELIST> 

<ATTRIBUTE displayname="Creation Date" n ame = " C RE AT I ONT I ME " 
class="Time"/> 

<ATTRIBUTE displayname="Last Modified Date" 
name= " LASTMODI FIEDTIME " class="Time " /> 

<ATTRIBUTE displayname="Creator" name=" CREATOR" class="Name"/> 
<ATTRIBUTE displayname="Document Type" name="DOCTYPE" 
class = "Selection" options = "TEXTFRAGMENT | LI STFRAGMENT | IMAGE FRAGMENT | 
AUDIOFRAGMENT | VI DEOFRAGMENT | INDEXGROUP | PRODUCTPAGE | SOMESERVABLE "/> 

<AT TRIBUTE displayname^'Page Type" name=" PAGET YPE" 
class="Selection" options=" Fragment | Servable"/> 

<ATTRIBUTE displayname= ,T Keyword" name=" KEYWORD" class="Text"/> 
<ATTRIBUTE displayname="Category" name— " CAT EGORY " 
lass="Selection" options=" Netf inity_8500R | Netf inity_7000_MlO I 
Netfinity_5500_M10 | Netf inity_5 600 | Netfinity_5500"/> 
</ATTRIBUTELIST> 
<CLASSLIST> 

<CLASS name="Time"> 

<OPERATOR name= ">="/> 
<OPERATOR name="<="/> 
<OPERATOR name="="/> 
<VALUE datatype="date"/> 
</CLASS> 

<CLASS name="Integer"> 

' < OPERATOR name =">="/> 

<OPERATOR name="<="/> 

<OPERATOR name="-"/> 

<VALUE datatype="integer"/> 
</CLASS> 

<CLASS name="Name"> 

<OPERATOR name="is"/> 

<OPERATOR name="isn' t"/> 

< OPERATOR name="starts with"/> 

<VALUE datatype="string"/> 
</CLASS> 
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<CLASS name="Text"> 

<OPERATOR name="is ,, /> 

<OPERATOR name=" starts with"/> 

<VALUE datatype="string"/> 
</CLASS> 

<CLASS name="Selection M > 

<OPERATOR name="is"/> 
<OPERATOR name="isn't"/> 
<VALUE datatype="choice M /> 
</CLASS> 
</CLASSLIST> 
<RESULTS> 

<ATTRIBUTE displayname="Last Modified Date" name= "LASTMODI FI EDT IME " 
class="Time "/> 

<ATTRIBUTE displayname="Creator " name -"CREATOR" class="Name"/> 
<ATTRIBUTE displayname="Title " name=" TITLE" class="Text "/> 
<ATTRIBUTE displayname=" Document Type" name="DOCTYPE" 
lass= "Selection" /> 
</RESULTS> 
</SEARCH> 

<ROLE name="FragmentEditor" displayname=" Fragment Editor"> 
< FRAGMENTS dispiayname=" Fragment "> 
<DTD displayname="Text" 
href="http: //f ranklinserver/f ranklin/dtd/textf ragment . dtd"/> 

<DTD displayname="List" 
href="http : //f ranklinserver/f ranklin/dtd/listf ragment . dtd"/> 

<DTD displayname= "Audio" 
href-"http: //f ranklinserver/f ran klin/dtd/audiof ragment .dtd"/> 

<DTD displayname="Video" 
href="http : //f ranklinserver/f ranklin/dtd/videof ragment .dtd"/> 

<DTD displayname=" Image" 
href="http : //f ranklinserver/f ranklin/dtd/imagef ragment . dtd"/> 
</ FRAGMENT S> 
</ROLE> 

<ROLE name=" Editor" displayname="Editor "> 
< FRAGMENT S di splayname= " Fragment " > 
<DTD displayname="Text" 
href="http: //f ranklinserver/f ranklin/dtd/textf ragment . dtd"/> 
</ FRAGMENTS > 

<SERVABLES displayname="Page"> 

<DTD displayname="News Article" 
href="http: //f ranklinserver/f ranklin/dtd/newsarticle . dtd"/> 

<DTD displayname=" Product Page" 
href="http : //f ranklinserver/f ranklin/dtd/productpage ,dtd"/> 
</SERVABLES> 
</ROLE> 
</FRANKLIN_INIT> 



From this franklin Jnitxml document, the Editor Ul builds the File > New Fragment and File 
>New Page menus. It also maintains the mappings between display names and DTD URLs in a 
hash table. 

The Editor UI can be set to load all DTDs at this point, if it is important to enable off-line 
editing. We have chosen to load a DTD from the server upon demand for a faster startup process. 
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At this point, the editor is able to either create new content or search for existing content in the 
system. 

Create new content 

The File > New Fragment menu lists all fragments and the File > New Page menu lists all 
servable pages the editor is allowed to create or edit. If the editor selects to create a new 
fragment, e.g. a TEXTFRAGMENT, the Editor UI gets the DTD from the appropriate URL and 
automatically generates a template from the DTD, as shown below: 



[Include screenshot here] 



In parallel, the Editor UI maintains in memory a DOM corresponding to the DTD. 



Editor UI Widgets 

The Editor UI uses the DATATYPE attributes in the DTD to generate the appropriate Java 
widget in the user interface. If an element does not contain a DATATYPE attribute no input is 
allowed for that element. Children elements may still contain DATATYPE attributes to specify 
their user interface. The mapping between Franklin UITYPEs and Java widgets are given below: 

date => JtextField 

integer => JtextField 

string => JtextField 

shorttext => JtextArea (scrolling) 

longtext => JtextArea (scrolling) 

choice => JComboBox (with Def aultComboBoxModel to hold the data) 

browselocal => JtextField (with JfileChooser to select local file) 
browseserver => JtextField (with custom JFrame to browse server 

directory) 

Each Java widget is encapsulated in a set of classes that include additional functionality. For 
example, if an element in the DTD is required, e.g. TITLE, the widget will be highlighted (e.g. 
colored brightly) to help the editor distinguish which fields must be filled in. If an element can 
appear more than once, e.g. KEYWORD, +/- buttons appear next to the widget that allow 
duplicating the widget or group of widgets. 

BODY tags are handled specially within the system. The system assumes that BODY tags are 
composed of 1 or more PARAGRAPH tags. Typically, this is represented by a longtext widget in 
the user interface. Blank lines in the input are interpreted as paragraph separators. When 
constructing the DOM object, these paragraphs are composed within the outer BODY tag. 

Check-in of New Fragment 

When the editor has filled in the template in the UI, clicking on the check-in icon verifies that all 
required elements are filled in. If so, the DOM in memory is populated with the data in the UI 
widgets. New nodes are added if new instances of an element have been created using the +/- 
buttons. Nodes are removed from the DOM if optional fields have not been filled in. Once the 
DOM mirrors exactly the UI, the document is transformed to an XML string and a request is sent 
to the Dispatcher with the XML as the body. 
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Note that the only time a check-in request to the Franklin Dispatcher does not include the file 
name containing fragmentid is when uploading a new fragment. The absence of a fragmentid 
indicates to the server that a new, unnamed fragment is being checked-in. The Dispatcher assigns 
^uiigue ids to all fragments._ ^-~{ Deleted 

Client request: 

PUT fragmentid HTTP1.1 
Host : f ranklinserver/f ranklinservlet 
Content-Type: text/xml; charset="utf-8 " 
Sessionld: 175a : dc8e0de306 : -8000 
Content-Length: length 

<?xml version="l . 0"?> 
<!DOCTYPE TEXT FRAGMENT SYSTEM 

"http : //adtech . ibmus2 . ibm.com/franklin/dtd/textfragment . dtd" > 
<TEXTFRAGMENT> 
<SYSTEM> 

< FRAGMENT I D / > 

<CREAT0R/> 

<MODIFIER/> 

<CREATIONTIME/> 

<LASTMODIFIEDTIME/> 

<PAGETYPE/> 

<CONTENTSIZE/> 
</SYSTEM> 

<TITLE>This is the title of this textf ragment</TITLE> 
<BODY> 

<PARAGRAPH>This is the document body< / PARAGRAPH> 
</BODY> 
</TEXTFRAGMENT> 

If check-in is successful the Dispatcher returns the SYSTEM data of the XML document filled in 
with the newly created unique fragmentid, and the authoring information, as described in Section 
XXX. The client merges the SYSTEM tag into the existing XML document. The Editor UI now 
has the complete XML. 

Dispatcher response: 

HTTP/1.1 200 OK 

Content-Type: text/xml; charset="utf-8 " 
Content-Length : length 
Sessionld: 175a : dc8e0de306 : -8000 

<?xml version="1.0"?><RESPONSE> 
<PROCESS>new Checkin</PROCESS> 
<STATUS>200</STATUS> 
<ERRORC0DE>OK</ERRORC0DE> 
<MESSAGE>OK</MESSAGE> 
<SYSTEM> 

<FRAGMENTID>4 6ba850dc8cf If 3cl007f 33-Tf rg .xml</FRAGMENTID> 
<CREATOR>Joe Doe</CREATOR> 
<MODIFIER>Joe Doe</MODIFIER> 

<CREATIONTIME>2000-01-07-14 .08 .09. 328000</CREATIONTIME> 
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<LASTMODIFIEDTIME^ /LASTMODIFIEDTIME> 
<PAGETYPE>Fragment</PAGETYPE> 
<CONTENTSIZE>537</CONTENTSI2E> 
</SYSTEM> 
</RESPONSE> 

If the fragment about to be checked in has an accompanying content file, i.e. a multimedia asset 

or an XSL style sheet, the Editor UI encodes the contents using Base64encoding into the 

CONTENT element in the XML. On the server side, the Dispatcher un-encodes it and writes the 

file to the file system, as described in Section XXX. This method avoids sending multiple 

requests to the Dispatcher and having to maintain state between two requests. 

Caveat: presently we are unclear on whether there is a size limitation to this method! And it is 

slow! 



Check-In of Modified Fragment 

If the Editor UI checks in a modified fragment or page, it will have received a locktoken from 
the Dispatcher before checking it out. The check-in request in this case must include the 
LockTocken header field z _ , - - i Deleted 



Client Request 

PUT fragmentid HTTPl.l 

Host : f ranklinserver/f ranklinservlet 

Content-Type: text/xml; charset="utf-8 " 

Sessionld: 175a: dc8e0de306 : -8000 

Content-Length: length 

LockTocken: 



The dispatcher verifies that the correct lock token is supplied with the PUT request before it 
processes the request. The dispatcher changes the MODIFIER and the LASTMODEFIEDTIME 
fields in the SYSTEM element. 

After the check-in command, the Editor UI issues an unlock command using the appropriate 

LOCKTOKEN. 

Client request: 

UNLOCK /12345678-tfrg.xml HTTPl.l 
Host : f ranklinserver/f ranklinservlet 
Sessionid = 175a : dc8e0de306 : -8000 
Locktocken = 12345678 



The Dispatcher verifies the locktoken as described in Section XXX, and returns an OK if the 
token is correct, otherwise it sends one of the two Franklin lock errors: 

# LI 01 = Lock tokens do not match 

# LI 02 = Missing lock token 
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Check-out 

To check out a fragment for editing from the Franklin Server, the Editor UI first requests a lock 
for the given fragment, as defined by the WebDAV protocol. 

Client request: 

LOCK /12345678-tfrg.xml HTTPl . 1 
Host : f ranklinserver/f ranklinservlet 
Sessionid = 175a: dc8e0de306: -8000 

If the fragment is already locked by another user, the dispatcher returns a response with 
information on who has locked it when, in case the user wants to contact the person who holds 
the lock. 

Dispatcher response: 

http/ l.i |2 q;o|_ OK 

Content-Type: text/xml; charset="utf-8" 
Content-Length: length 
Sessionid: 175a :dc8e0de306 : -8000 

<?xml version="l. 0 M ?> 
<RESPONSE> 

<PROCESS>Lock</PROCESS> 

<STATUS>200</STATUS> 

<ERRORCODE>OK</ERRORCODE> 

<MESSAGE>Locked</MESSAGE> 

<LOCK> 

<LOCKEDBY> Jane Mano*- /T ^KEDBY> 
<LOCKTIME> 'LOCKTIME> 
</LOCK> 
</RESPONSE> 

If the fragment is not already locked and if the user with the sessionid is allowed to edit 
documents based on the DTD of the requested fragment, the dispatcher creates a unique lock on 
the fragment as described in section Dispatcher: Lock Management. It also sends the lock token 
back in the response. 

Dispatcher response: 

HTTP/1.1 200 OK 

Content-Type: text/xml; charset="utf-8" 
Content-Length: length 
Sessionid: 175a :dc8e0de306 : -8000 

<?xml version= M l . 0"?> 
<RESPONSE> 

<PROCESS>Lock</PROCESS> 

<STATUS>200</STATUS> 

<ERRORCODE>OK</ERRORCODE> 

<MESSAGE>OK</MESSAGE> 

<LOCK> 

<LOCKEDBY> Joe Moe</LOCKEDRY> 

<LOCKTIME> /LOCKTIME> 
<LOCKTOKEN>12345 678</LOCKTOCKEN> 



„ - : Comment [DM5]: Should not be 200 ;. ; 

:;(ni-have to check) 5 * '■■ ' 
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</LOCK> 
</RESPONSE> 

Now the Editor UI can request the fragment for editing using the lock received from the server. 
Client request: 

GET /12345678-tfrg.xml HTTP1.1 

Host : f ranklinserver/f ranklinservlet 

Content-Type: text/xml; charset="utf-8 " 

Locktocken = 12345678 

Sessionid = 175a:dc8e0de306 : -8000 

The Dispatcher compares the lock to the one saved in the Meta Data Store. If they match, 
Dispatcher responds by sending back the complete XML of the fragment. 

Dispatcher response: 

HTTP/1.1 200 OK 

Content-Type: text/xml; charset="utf-8" 
Content-Length: length 
Sessionid: 175a : dc8e0de306 : -8000 

<?xml version="l. 0"?> 
<!DOCTYPE PRODUCT PAGE SYSTEM "http : //f ranklinserver/dtd/productpage . dtd"> 
<PRODUCTPAGE> 
<SYSTEM> 

</SYSTEM> 

</PRODUCTPAGE> 

The Editor UI retrieves the DTD of the checked-out fragment from the server if it has not yet 
loaded it. Using the DTD it auto-generates the UI widgets and then fills in the existing values 
from the checked-out fragment, adding new instances of elements using the +/- mechanism when 
necessary. 

The editor can modify the fields in the same way as when creating new content. Upon check-in 
the Dispatcher updates the lastmodifedtime and modifier fields in the system data of the 
checked-in XML document. 

Search 

Clicking on the Search icon in the Editor UI brings up the Search dialogue shown below: 
[insert Search screen shot here] 

When launched, the Search dialogue parses franklin Jnitxml and stores attributes, operators and 
allowed values into hash tables. It dynamically generates the widgets for the query composition. 
When new attributes or values are added to franklin Jnitxml, the Search code does not need to 
be updated. 

The Search UI communicates with the Dispatcher using the Distributed Authoring Search 
Language (DASL) [add ref], an extension to the WebDAV protocol. Franklin Server defines the 
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"Franklin" name space which allows the insertion of properties that correspond to the names of 
the indexed elements in Franklin Meta Data Store. 

An example of a DASL exchange between Search UI and Dispatcher is shown below for the 
example Boolean query: 

(AND 

( PAGET YPE "is" "Fragment") 
(LASTMODIFIEDTIME "gte" " 
{CREATOR "is not" "Jeff Milton'')) 

Search request: 

SEARCH / HTTPl . 1 

Host : franklinserver/f ranklinservlet 
Content-Type: text/xml; charset="utf -8 " 
Sessionid = 175a : dc8e0de306 : -8000 

<?xml version="l . 0"?> 

<d: searchrequest xmlns : d="DAV : " xmlns : f=" Franklin : "> 
<d: basics earch> 
<d:select> 
<d: prop> 

<f : FRAGMENT ID/ > 
<f :DTD/> 

<f :LASTMODIFIEDTIME/> 
<f :TITLE/> 
<f :CREATOR/> 
</d:prop> 
</d: select> 
<d: from> 
<d: scope> 
<d:href/> 

<d : depth>inf inity</d : depth> 
</d: scope> 
</d: f rom> 
<d:where> 
<d:and> 
<d:eq> 

<d:prop> <f :PAGETYPE/> </D:prop> 

<d:literal>Fragment</D:literal> 
</d:eq> 
<d:gte> 

<d:prop> <f :LASTMODIFIEDTIME/> </D:prop> 

<d:literal>1999-10-10</D:literal> 
</d:gte> 
<d:not> 

<d:eq> 

<d:prop> <f:CREATOR/> </D:prop> 
<d: literal>Jef f Milton</D: literal> 
</d:eq> 
</d:not> 
</d: and> 
</d: where> 
<d:limit> 
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<d:nresults>2</d:nresults> 
</d:limit> 
</d:basicsearch> 
</d: searchrequest> 

The Dispatcher passes the query to the Meta Data Store where the query is converted to SQL and 
executed against DB2. The results are converted back to the DASL format. 

Currently, we are using the d:nresults tag to indicate a range of results to be returned, (e.g. 
<d:nresults>l-50</d:nresults>) This enables the client to request subsequent "pages" from a 
search with a large number of results. 

Dispatcher response: 

HTTP/1.1 207 Multi-Status 
Content-Type: text/xml; charset-"utf-8" 
Content-Length: length 

<?xml version="l . 0"?> 

<d:multistatus xmlns : d="DAV : " xmlns : f="Franklin : "> 
<f : responsesummary> 



<d : href >http: //franklin. adtech. ibm.com/4398754 8-tf rg.xml</d : href > 
<d:propstat> 

<d:prop> 

<f : FRAGMENTID>43987548-tf rg . xitil</f : FRAGMENT I D> 
<f :DTD>Textfragment</f :DTD> 
<f : PAGETYPE>Fragment</f : PAGF,TYPF:> 
< f : LASTMODI FIEDTIMEX 
< / f : LASTMODI FI EDT IME> 

<f:TITLE>Lou Gerstner's bio</f :TITLE> 
<f :CREATOR/>Joe Moe</f :CREAT0R> 
</d:prop> 
</d:propstat> 
</d: response> 
<d: response> 

<d : href >ht tp: //franklin. adtech. ibm.com/9999 999- frg.xml</d: href > 
<d:propstat> 



<d:prop> 

<f : FRAGMENTID>9999999-tfrg.xml</f : FRAGMENTID> 
<f : DTD>Listf ragment</f : DTD> 
<f :PAGETYPE>Fragment</f : pakf.typt^ 
< f : LASTMODI FIEDTIME> 
</f : LASTMODI FIEDTIME> 

<f :TITLE>Highlights for Netfinity 8500R</f : TITLE> 
< f : CREATOR/> Jane Mane< / f : CREAT0R> 
</d:prop> 





specified,^ (Tdoii't ,t^kj^| ; ' A 



</f : responsesummary> 
<d: response> 



</d:propstat> 
</d: response> 
</d :multistatus> 
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The Search UI parses the results and displays them in the results table. From the table, the editor 
can select items and merge them into the Active List in the Editor UI. 

Future: If more than the requested number of hits exist in the database, the Search UI uses the 
responsesummary element in the result list to determine how to manage the "Next" and 
"Previous" buttons that allow further results or to go back to a previous set of results. 

Preview 

Before checking in a servable, the editor can preview the final page to be published. The preview 
icon in the Editor UI is active only when editing a servable. Requesting a preview sends a 
request to the Preview Manager servlet with the temporary contents of the servable XML. The 
Preview Manager expands the servable with contents of any subfragments, assembles the page 
with all included style sheets using LotusXSL, and returns the resulting HTML output to the 
client. 

The Editor UI launches the web browser specified in the franklin.properties file and displays the 
temporary output. Once satisfied, the editor can check in the servable. Servables previously 
checked in (e.g., servables returned as search results) can also be previewed. 

(Future: preview of an HTML page does not indicate to the editor which fragment produced any 
given area of the page. Need to devise a way to display the source element.) 

Dispatcher 

Session Management 

When a user logs on using the Editor UI, as described in the Section Editor Interface & 
Dispatcher Communication: Login, the dispatcher checks for a valid user and password by 
consulting the DOM, generated at startup, which contains ail user information. If they are valid, 
the. dispatcher adds the user to the currentusers hash table and generates a unique session 
identifier, sessionld. Sessionld is created using the java UIDO call that guarantees to return a 
unique identifier for the machine the process is running on. 

If the same user logs on a second time from another terminal without terminating the earlier 
session, the earlier sessionld in overwritten by a new one, and the old session becomes invalid. 

At logout, the users entry is removed from the currentusers hash table. 

Future: the class that manages the user sessions must be serializable, so that its state can be 
saved and reloaded if the Franklin Server servlet needs to be restarted. 

System Data Creation 

When a dispatcher receives the check in request from the Editor UI, it handles new and modified 
fragments differently. 
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For a new fragment, the Dispatcher fills in the following so-called system elements in the DOM 
built from the incoming fragment: 

<SYSTEM> 

<FRAGMENTID>4 6ba850dc8cf If 3cl007f 33-t f rg . xml</ FRAGMENT I D> 
<CREATOR>Joe Doe</CREATOR> 
<MODIFIER>Joe Doe</MODTFT^R> 

<CREATIONTIME>: /CREATIONTIME> 
< LAS TMODI FI EDT IME> LASTMODI FIEDTIME> 

< PAGET YPE> Fragment </ PAGET YPE> 
<CONTENTSIZE>537</CONTENTSIZE> 
</SYSTEM> 

fragment id is the unique identifier for the fragment. This identifier is created using the java 
UIDQ call which returns a guaranteed unique identifier for the machine where the process is 
running. To the UID, the dispatcher appends the suffix -tfrg.xml for simple fragments, -bfrg.xml 
for compound fragments, or -tsrv.xml for servables. To know which suffix to append, the 
dispatcher consults the dtdToType hash table, built at startup to cache the mapping between 
DTDs and their types. 

creator is the name of the user who originally checked in the new fragment. The dispatcher gets 
this name by calling the sessionidToUser method, which retrieves the user name from the 
currentusers hash table based on the sessionld. 

modifier is the name of the user who is currently checking in the fragment, modifier and 
creator are the same when creating the system data for a new fragment. 

creationtime is the Java generated time stamp of the system data creation time at original 
check-in. 

lastmodifiedtime is the Java generated time stamp of the system data update time at 
subsequent check-ins. creationtime and lastmodifiedtime are the same for a new 
fragment. 

pagetype is set to either "fragment" or "servable". The dispatcher sets pagetype by 
consulting the dtdToType hash table, built at startup to cache the mapping between DTDs and 
their types. This field is important because processing of fragments and servables is different in 
the Editor UI as well as in the content store module. 

contentsize is the size in bytes of the checked-in fragment including any included binary data. 
The dispatcher calculates this after filling in the system data but before extracting any binary 
data. Thus, this is the size of the string being sent over the network between Editor UI and the 
dispatcher. 

Name Space Management 

The name space manager module of the dispatcher manages all reading and writing of files. It 
abstracts away the actual file system from all other modules, so that they do not have to keep 
track of specialized directories. 
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The name space manager provides the functionality to read and write into the file system DOMs, 
corresponding XML strings that represent fragments or servables. At dispatcher startup, the 
initialization file is read in, and the variables defining the directories become available to the 
name space manager. 

When writing a compound fragment, the name space manager also extracts any encoded 
multimedia files and style sheets and writes them into the appropriate directories. On the other 
hand, when reading a compound fragment, it encodes any external files into the XML and 
returns the DOM to the module requesting it. 

In addition to the dispatcher, the content store uses the name space manager as well. The content 
store uses it to read fragments from the file system and to write HTML/HDML/DHTML output 
files from page assembly into the file system. 

The advantage of separating the name space manager from the rest of the Franklin server is to 
isolate the knowledge about dedicated file system directories to one module. For example, if 
xmlDir needed to be split up into a series of second-level directories to limit the size of any one 
directory, only the name space manager would need to know about the change. Under xmlDir 
could reside 10 child directories 0/, 1/, ...9/ and a fragment would be stored in one of them based 
on a load-balancing algorithm handled by the name space manager. 

Coordination Between Modules at Check-in 

[describe the 3 phase save to file system, meta store and tm, with the fact that tm is 
asynchronous. Maintenance of pending jobs table by dispatcher, and roll-back] 

Lock Management 

As described in the sections Editor Interface & Dispatcher Communication: Check-in and 
Check-out, the Editor Ul and dispatcher exchange lock tokens during the LOCK and UNLOCK 
requests from the Editor UL 

When the dispatcher issues a lock token, it uses the Java UIDQ call to create a unique identifier. 
It sends the token along with the user name and the lock time to the Editor UI in the body of the 
response and stores another copy of this information in the meta-data store as described in the 
section Meta Data Store: Lock Management. 

When the dispatcher receives an UNLOCK request with a lock token from the Editor UI, it needs 
to verify that the token matches the one stored in the meta-data store. If they match, the 
dispatcher issues a call to delete the lock in the meta-data store. 

The dispatcher has two other ways to manage locks if problems occur. If the Editor UI requests 
that all locks held by the current user be released, the dispatcher issues the call 
releaseLockByUser to the meta-data store. When the dispatcher is restarted due to a system 
crash, all pending locks in the meta-data store can be released at startup with the call 
releaseLockAll 
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Error Handling 

All Franklin server side components abide to the same Franklin error handling scheme. When 
any of the components called by dispatcher, namely meta-data store, name space manager, user 
manager, or content manager, catch or throw a Java exception, they convert it to a Franklin 
exception and fill in all details about the context and the conditions where the error occurred. 

A Franklin exception contains the following attributes: 

myError - the Franklin error code 

myHttpError - the HTTP error code corresponding to the Franklin error code 
myMessage - explanation of error, presented to user of the Client application 
my Destination - one of ERRORJJSER, ERROR_LOG, ERROR_ADMIN to indicate 
where the error should be directed 

myException - the originally caught exception, if there is one 

The dispatcher module routes the exception based on the attributes. If myDestination is set to 
ERRORJJSER, the dispatcher returns the exception to the Editor UI which displays the error to 
the user. If it is set to ERROR_LOG, the error is written to the error log file, and for 
ERROR_ADMIN, the process notifies the system administrator. 

Meta Data Store 

The meta-data store allows the indexing and searching of fragments and servables. All or a 
subset of the XML elements can be set to be indexed. For a large content site this allows users to 
quickly locate content objects of interest. The meta-data store also manages the lock information 
of content objects. 

DB2 XML Extenders 

Franklin uses XML Extenders for DB2 to index a subset of the XML elements of fragments and 
servables. To accomplish indexing, XML Extenders uses a Document Access Definition (DAD) 
that maps an XML element to a column in a DB2 table. 

DB2 XML Extenders provides two different methods, namely XColumn and XCollection. We 
have implemented both methods in Franklin and decribe both in this document. We recommend 
using the XCollection as it is more flexible. 

XColumn 

The current XColumn implementation of XML Extenders can only map one DTD to one or more 
DB2 tables. In order to map all Franklin DTDs to one or more common tables, the dispatcher 
converts all DTDs to a so-called universal DTD, which contains all elements to be indexed in the 
set of DTDs. For this universal DTD, two DADs are created based on the XML Extenders 
syntax. 

Two DADs are needed, because the current XColumn implementation does not support inserting 
elements that occur only once in the XML and those that occur more than once using a single 
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DAD. Thus, the examples in this section show two DADs that map values from the universal 
DTD. 

When designing the DADs, all elements that appear only once, or single-occurrence elements, 
can be mapped to one table. Any elements that can appear more than once, or multi-occurrence 
elements, need to be mapped each into separate dedicated tables. The administrator creates a 
view between the single-occurrence table and the multi-occurrence tables to perform searches 
across all tables with one command. 

A DAD specifies the following items: 

table name = name of the DB2 table 

column name = name of the column in the encapsulating table 
column type = data type of the column 

column path = XPath expression from the root to the element to be indexed 
in the column 

column multi-occurrence = flag to indicate whether the element at the path 
can occur more than once 

Example of a DAD mapping single-occurrence elements: 

<?xml version="l . 0"?> 

<!DOCTYPE DAD SYSTEM "c : \dxx\f ranklin\dtd\univer sal . dtd"> 
<DAD> 

<dtdid>UNIVERSALDTD</dtdid> 
<validation>NO</validation> 
<Xcolumn> 

<table name= "MET A . MAIN"> 
<column name= "CREATOR" 
type="varchar (50) " 
path= " /UNIVERSAL/ SYSTEM/CREATOR" 
multi_occurrence="NO"> 
</column> 

<column n ame = " C REAT I ON T I ME " 
type=" TIMES TAMP" 

path= " /UNIVERSAL/SYSTEM/ CREATIONTIME" 
multi_occurrence="NO"> 
</column> 

<column name= " LASTMODI FIEDT IME " 
type="TIMESTAMP" 

path=" /UNI VERS AL/SYSTEM/LASTMODI FIEDT IME " 
multi_occurrence="NO"> 
</column> 

<column name=" PAGET YPE" 
type="char (10) " 

path=" /UNIVERSAL/SYSTEM/PAGETYPE" 
multi_occurrence="NO ,, > 
</column> 

<column name= "CONTENTS I ZE" 
type= " integer " 

path=" /UNIVERSAL/SYSTEM/ CONTENTS IZE " 
multi_occurrence="NO"> 
</column> 

<column name="TITLE" 
type="varchar (250) " 
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path= " /UNIVERSAL /TITLE " 
multi_occurrence="NO"> 
</column> 

<column name="DOCTYPE" 

type="varchar (32) " 

path= "/UNIVERSAL/DOCTYPE" 

multi_occurrence="NO"> 
</column> 

<column name="DTDURL " 
type="varchar (512) " 
pa th= " /UNIVERSAL /DTDURL " 
multi_occurrence="NO"> 
</column> 
</table> 
</Xcolumn> 

Example of a DAD mapping multi-occurrence elements: 

<?xml version="1.0"?> 

<!DOCTYPE DAD SYSTEM "c : \dxx\f ranklin\dtd\univer sal . dtd M > 
<DAD> 

<dtdid>UNIVERSALDTD</dtdid> 
<validation>NO</validation> 
<Xcolumn> 

<table name="META . CATEGORY "> 
<column name=" CATEGORY" 
type="varchar (128) " 
path=" /UNIVERSAL/CATEGORY " 
multi_occurrence="YES"> 
</column> 
</table> 

<table name="META. KEYWORD" > 
<column narae= " KEYWORD " 
type="varchar (64) " 
path=" /UNIVERSAL /KEYWORD" 
multi_occurrence-"YES"> 
</coluinn> 
</table> 
</Xcolumn> 
</DAD> 

The tables created by these DADs are shown in the Section Table Design. 
XCollection 

The XCollection implementation of XML Extenders requires one DAD for each DTD to be 
mapped into DB2. Unlike XColumn, different DTDs can be mapped to the same DB2 tables. 
Thus, the XCollection implementation does not required documents to be converted to abide to 
one universal DTD. 

[However, the current XCollection also has a few problem. We have implemented a temporary 
fix into the meta data store until the problems are addressed] 

The DAD corresponding to textfragmentdtd is shown below: 
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[add DAD here] 



Table Design 

When a DAD is loaded into DB2, the tables and columns specified in it are automatically 
created. After the tables are created, the administrator needs to add the following items to the 
database: 

- a column named ISCOMMIT in the table storing the single-occurrence elements. This 
column indicates if the fragment has successfully been committed to the content store 
and file system 

- indexing on any columns that will be searched 

- a view which combines data from all tables for searching 

The database tables created by the previous DAD examples are shown below, along with keys, 
indexes, and the ISCOMMIT column created by the administrator. 

Schema: 

MET A: Used for all the tables used by Franklin 
INDEX: Used for all the indexes used by Franklin 

Tables Generated by DAD: 

META.MAIN: This table contains all the elements that occur at most once in 
the input XML document 



Column Name 

FRAMENTID 

CREATOR 

C RE AT I ONT I ME 

LASTMODIFIEDTIME 

CONTENTS I 2E 

TITLE 

PAGETYPE 

DOCTYPE 

DTDURL 

ISCOMMIT 



Data Type 

CHAR (56) 

VARCHAR{50) 
TIME-STAMP 

TIMESTAMP 

INTEGER 
VARCHAR 
CHAR (10) 
VARCHAR (32) 

VARCHAR (512) 
INTEGER 



Default 



Key 

Fk -> 
unif ragl 



Index 

index. fragment 
id 

index. creator 
index . creation 
time 

index . lastmodi 
f iedtime 

index. title 
index . pagesize 
index . doctype 
index. dtdurl 



META. KEYWORD: This table contains the KEYWORD elements associated with a 
given FRAGMENTID: 



Column Name 
FRAMENTID 



Data Type 
CHAR(56) 



Default 



Key 

Fk -> 
unif rag2 



Index 

index. fragment 
ed 
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KEYWORD 



VARCHAR(64) 



index . keyword 



META. CATEGORY: This table contains the CATEGORY elements associated with a 
given FRAGMENTID. 

Column Name Data Type Default key index 

FRAMENTID CHAR(56) fk index . fragment 

id 

CATEGORY 

VARCHAR (128) index . category 



UNIFRAG1: This table contains two fields, 

Fragmentid - the fragmented for a given XML file 
Fragmentxml - the XML file stored in the file system 

The function of this table is to trigger filling META. MAIN when a record is 

inserted 

Column Name Data Type Default key index 

FRAMENTID CHAR (56) PK 

FRAGMENTXML 

DB2XML .XMLFILE 



UNIFRAG2: This table has the same structure as ONI FRAG 1. The function is to 
trigger filling META. KEYWORD and META . CATEGORY when a record is inserted 

Column Name Data Type Default key index 

FRAMENTID CHAR (5 6) PK 

FRAGMENTXML 

DB2XML. XMLFILE 

Index 

When a fragment or servable is checked in, the dispatcher converts the XML file to abide to the 
universal DTD for indexing in the XColumn implementation. After the conversion, it sends the 
universal XML to the meta-data store. In the XCollection implementation, the fragment or 
servable is sent as is to the meta-data store. 

For XCollection, the meta-data store enters a pointer to the file into the two tables named 
dn it frag l and unifrag2 in the previous example. When the record is entered, a trigger copies 
the elements specified in the DAD to the appropriate tables. The elements are now ready for 
searching. 

For XColumn ... 
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Search 

When the Search UI sends a DASL search expression, described in the section Editor Interface & 
Dispatcher Communication: Search, to the dispatcher it passes it directly to the meta-data store. 
The meta-data store converts it to an SQL expression, executes the SQL query and converts the 
results to the DASL output format. 

An example DASL query: 

<?xml version="1.0"?> 

<d: searchrequest xmlns : d="DAV : " xmlns : f=" Franklin : "> 
<d : basics ear ch> 
<d: select> 
<f :prop> 

<f :FRAGMENTID/> 
<f:DOCTYPE/> 
<f :LASTMODIFIEDTIME/> 
<f :TITLE/> 
<f :CREATOR/> 
<f : PAGETYPE/> 
</f :prop> 
</d: select> 
<d: from> 
<d: scope> 
<d:href /> 

<d:depth>inf inity</d:depth> 
</d:scope> 
</d: f rom> 
<d: where> 
<d:and> 
<d:like> 
<d:prop> 

<f:KEYWORD/> 
</d:prop> 

<d : literal>SERVER</d : literal> 
</d:like> 
<d:like> 

<d:prop> 

<f : PAGETYPE/> 

</d:prop> 

<d : literal >FRAGMENT</d : literal> 
</d:like> 
</d:and> 
</d: where> 
<d:limit> 

<d:nresults>l-50</d:nresults> 
</d:limit> 
</d:basicsearch> 
</d : searchrequest> 

The above DASL query converted to SQL: 
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SELECT DISTINCT fragmentID, doctype, lastModifiedTime, title, creator, 
pagetype FROM meta .metaall where KEYWORD LIKE ' SERVER% ' and PAGETYPE LIKE 
' FRAGMENT ' and iscommit = 1 

An example DASL output to above query: 

<?xml version="1.0"?> 

<d:multistatus xmlns:d ="DAV : " xmlns : f=" Franklin : "> 
<f : responsesummary> 

<f : start>K/f : start> 

<f :end>K/f :end> 

<f :total>K/f :total> 
</f : responsesummary>/ 
<d: response> 

<d:href>http://franklinserver/4 6b3e60dccbcd84db007777-tfrg.xml 
</d:href> 
<d:propstat> 
<d:prop> 

<f : FRAGMENTID>4 6b3e60dccbcd84db007777-tfrg.xml</f :FRAGMENTID> 
<f : DOCTYPE>TEXTFRAGM^NT< / f : nnrTYDirs 

< f : LASTMOD I FI EDT IME: ' f : LASTM0D I FI EDT IME> 

<f : TITLE>Netf inity Highlights</f : TITLE> 
<f :CREATOR>Joe Doe< / f : CREATOR> 
<f :PAGETYPE>FRAGMENT</f : PAGETYPE> 
</d:prop> 
</d :propstat> 
</d:response> 
</d:multistatus> 

If the number of results is larger than the result set requested by the Search UI, the meta-data 
store writes the full results into a cache file and only encodes the requested number into the 
DASL output. The cache file is named using an expression that encodes the query and the 
sessionld of the user. When the Search UI requests the "Next" set of results for the same query, 
the meta-data store does not re-execute the query. Instead it consults the cache file and extracts 
the appropriate next set of results. This caching scheme saves the meta-data store from executing 
the same query several times if the user if simply navigating within the same result set. 

Note that if the contents where to change in DB2, the user does not see the updated results until 
he re-executes the original query without the "Next" or "Previous" flags. 

Lock Management 

When the dispatcher receives a lock command from the Editor UI, it creates a lock for a 
fragment or servable and sends the lock to the meta-data store to save in DB2. The lock 
information, namely locktoken , lockedowner, and locktime, is stored in the meta . lock 
table of the following format: 

Column Name Data Type Default Key Index 



FRAMENTID 
LOCKOWNER 
LOCKTIME 
LOCKTOKEN 



CHAR (56) PK 

VARCHAR(50) 

TIMESTAMP 

VARCHAR{34) 



A 
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When the dispatcher receives an unlock command from the Editor UI, it issues the unlock 
command to the meta-data store. The meta-data store deletes the record from the met a. lock 
table. 

The Content Store - Daedalus (a.k.a Trigger Monitor) 

This section describes how the Franklin project has extended three of the Daedalus handlers to 
enable the system to manage XML fragments and XSL style sheets. For the full Daedalus API 
documentation, read http://w3.watson.ibm.com/-chalIngr/papers/daedaIus/index.html. 

Daedalus is written in pure Java and implements handlers as pre-defined actions performed on 
the various configurable resources. Flexibility is achieved via Java's dynamic loading abilities, 
by more sophisticated configuration of the resources used by Daedalus, and through the use of 
handler preprocessing of input data. Most entities defined in a configuration file implement a 
public Java interface. Users may create their own classes to accomplish localized goals, and 
specify those classes in the configuration file. This permits run-time flexibility without requiring 
sophisticated efforts on the part of most users, since default classes are supplied to handle the 
most common situations. 

For Franklin, we have created our own classes to implement three handlers: the Extension Parser, 
the Dependency Parser, and the Page Assembler. 



Extension Parser 

Within Franklin, Daedalus manages different types of files differently based on their extensions. 
Servables, simple, compound, and index fragments, style sheets and multimedia assets are all 
treated slightly differently in the publishing flow. 



123445-trfg, 


. xml 


=> 


tfrg 


123445-bfrg. 


. xml 


=> 


bfrg 


123445-ifrg. 


. xml 


=> 


if rg 


123445-tsrv. 


. xml 


=> 


tsrv 


123445-sfrg. 


. xml 


=> 


sf rg 


web_index.xsl 


=> 


xsl 



The Franklin Extension Parser takes in a name of a fragment, and returns an extension used in 
the Daedalus configuration files to specify actions to take during the publish process: 

{text fragment) 
(binary wrapper fragment) 
(index fragment) 
(text servable fragment) 
(style sheet wrapper fragment) 
(style sheet) 

The appropriate behavior for each type of fragment (e.g. source-to-sink, assemble-to-sink) is 
defined in the Daedalus configuration files. Generally, only servables are assembled to the sink. 

Dependency Parser 

The Franklin Dependency Parser reads through an XML objects that has been checked in and 
detects two types of dependencies: 

1 . Servables and fragments can include subfragments, these get stored as an edge of type 
"composition" in the Daedalus Object Dependency Graph (ODG). 

2. Compound fragments include an associated content file, this dependency gets stored as 
an edge type "composition" in the ODG. 

3. Servables can include style sheets, these get stored as an edge type "stylesheet" in the 
ODG. 
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Dependencies are considered to point from the subfragments to the fragments that include them. 
For binary wrappers, one composition dependency points from the wrapper to the fragment that 
includes it, and another points from the wrapper to the binary data file that it wraps. For 
stylesheets, a composition dependency points from the wrapper to the stylesheet, and a stylesheet 
dependency points from the stylesheet to the servable that uses it. 

Page Assembler 

The Franklin Page Assembler expands a servable by including the contents of all included 
subfragments, and combines the resulting XML with the one or more style sheets using 
LotusXSL to produce HTML output files. The extension of each of the resulting files is 
determined from the stylesheet names (e.g. webxxxhtml.xsl). The assembled XML and all the 
resulting HTML files are written to one file, which is later split up in the Dispatcher, and the 
HTML files are written to the appropriate directories in the sink or server. 

Chaining of Trigger Monitors 

Currently, two Trigger Monitors are used in the publish process. They share an ODG, and the 
sink of the first one is the source of the second, creating a publishing chain. The following 
diagram shows the set-up of the Content store in its entirety: 
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When a fragment is checked in to the Content store, it is added to the shared ODG, and a publish 
command is issued to the first TM. The TM reads the fragment XML from the source servlet, 
uses the extension parser to find its extension, and then uses the dependency parser to find 
dependencies to add to the ODG. The page assembler then pulls in the contents of the 
fragment's subfragments, and if the fragment is a servable, combines it with its stylesheets to 
produce the output HTMLs. The servable XMLs, output HTMLs, binary files, and stylesheets 
are sent to the servlet specified as the sink of the first TM. 

When a servable has been approved, a publish command on the servable fragment is issued to 
the second TM. It is reassembled and recombined with its XSLs, and the resulting XML and 
HTMLs are published to the second sink servlet. Binary files (such as images) are also 
published to the second sink. This is where the web server pulls the final HTML and image files 
from. 

Example application 

- managing Netfinity pages at ibm.com 

Summary 



Appendix 1: Error Codes 

# Status code (101) indicating the server is switching protocols 

# according to Upgrade header. (SC_SWITCHING_PROTOCOLS) 

XI = 101 

# Status code (200) indicating the request succeeded normally. (SC_OK) 

G200 = 200 
P200 = 200 
OK -200 

# Status code (201) indicating the request succeeded and created 

# a new resource on the server. (SCCREATED) 

X3 = 201 

# Status code (202) indicating that a request was accepted for 

# processing, but was not completed. (SC_ACCEPTED) 

X4 = 202 

# Status code (203) indicating that the meta information presented 
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# by the client did not originate from the server. 
(SC NON AUTHORITATWE ^FORMATION) 

X5 = 203 

# Status code (204) indicating that the request succeeded but that 

# there was no new information to return. (SCNOCONTENT) 

X6 = 204 

# Status code (205) indicating that the agent <em>SHOULD</em> reset 

# the document view which caused the request to be sent. (SC_RESET_CONTENT) 

X7 = 205 

# Status code (206) indicating that the server has fulfilled 

# the partial GET request for the resource. (SCJPARTIAL_CONTENT) 

X8 = 206 

# Status code (300) indicating that the requested resource 

# corresponds to any one of a set of representations, each with 

# its own specific location. (SC_MULTIPLE_CHOICES) 

X9 = 300 

# Status code (301) indicating that the resource has permanently 

# moved to a new location, and that future references should use a 

# new URI with their requests. (SC MOVED PERMANENTLY) 

X10 = 301 

# Status code (302) indicating that the resource has temporarily 

# moved to another location, but that future references should 

# still use the original URI to access the resource. (SC_MOVED_TEMPORARILY) 

XI 1 =302 

# Status code (303) indicating that the response to the request 

# can be found under a different URI. (SC_SEE_OTHER) 

X12 = 303 

# Status code (304) indicating that a conditional GET operation 

# found that the resource was available and not modified. (SC NOT MODLFIED) 



X13=304 



# Status code (305) indicating that the requested resource 

# <em>MUST</em> be accessed through the proxy given by the 

# <code><em>Location</em></code> field. (SC_USE_PROXY) 

X14 = 305 

# Status code (400) indicating the request sent by the client was 

# syntactically incorrect. (SC_BAD_REQUEST) 

# THIS IS THE GENERAL (DEFAULT) ERROR RETURNED WHEN ANYTHING BREAKS 

#check c 102 to make sure it belongs in this area (400) 

C101 =400 

C102 = 400 

C103=400 

C123=400 

C124 = 400 

D104 = 400 

DUO = 400 

P101=400 

V101=400 

FI00 = 400 

F101 =400 

F102 = 400 

F103 = 400 

F104 = 400 

F105 = 400 

R101 =400 

R112 = 400 

R102 = 400 

R103 = 400 

R105 = 400 

D101 =400 

Dill =400 

D145 = 400 

G103 = 400 

# Status code (401) indicating that the request requires HTTP 

# authentication. (SC_UNAUTHORIZED) 

G101 =401 
U101 =401 
U102 = 401 
U103 = 401 
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L101 =401 
L102 = 401 
G104 = 401 

# Status code (402) reserved for future use. (SC_PAYMENT_REQUIRED) 
X17 = 402 

# Status code (403) indicating the server understood the request 

# but refused to fulfill it. (SCJFORBEDDEN) 

G102 = 403 
D123 = 403 

# Status code (404) indicating that the requested resource is not 

# available. (SC_NOT_FOUND) 

X19 = 404 

# Status code (405) indicating that the method specified in the 

# <code><em>Request-Line</em></code> is not allowed for the resource 

# identified by the <code><em>Request-URI</em></code>. 
(SCMETHODNOTALLOWED) 

X20 = 405 

# Status code (406) indicating that the resource identified by the 

# request is only capable of generating response entities which have 

# content characteristics not acceptable according to the accept 

# headerssent in the request. (SC NOT ACCEPTABLE) 

F108 = 406 

# Status code (407) indicating that the client <em>MUST</em> first 

# authenticate itself with the proxy. (SCPROXYAUTHENTICATIONREQUIRED) 

X22 = 407 

# Status code (408) indicating that the client did not produce a 

# requestwithin the time that the server was prepared to wait. (SC_REQUEST_TIMEOUT) 
X23 = 408 

# Status code (409) indicating that the request could not be 

# completed due to a conflict with the current state of the 

# resource. (SC_CONFLICT) 

X24 - 409 
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# Status code (410) indicating that the resource is no longer 

# available at the server and no forwarding address is known. 

# This condition <em>SHOULD</em> be considered permanent. (SCJ30NE) 

X25 = 410 

# Status code (411) indicating that the request cannot be handled 

# without a defined <code><em>Content-Length</em></code>. (SCLENGTHREQUIRED) 
X26 = 411 

# Status code (412) indicating that the precondition given in one 

# or more of the request-header fields evaluated to false when it 

# was tested on the server. (SCJPRECONDITION_F AILED) 

X27 = 412 

# Status code (413) indicating that the server is refusing to process 

# the request because the request entity is larger than the server is 

# willing or able to process. (SCREQUESTENTITYTOOLARGE) 

X28-413 

# Status code (414) indicating that the server is refusing to service 

# the request because the <code><em>Request-URI</em></code> is longer 

# than the server is willing to interpret. (SC_REQUEST_URI_TOO_LONG) 

X29 = 414 

# Status code (415) indicating that the server is refusing to service 

# the request because the entity of the request is in a format not 

# supported by the requested resource for the requested method. 
(SCJJNSUPPORTEDJvlEDIAJTYPE) 

X30 = 415 

# Status code (500) indicating an error inside the HTTP server 

# which prevented it from fulfilling the request. (SC INTERNAL SERVER ERROR) 
X31 =500 

# Status code (501) indicating the HTTP server does not support 

# the functionality needed to fulfill the request. (SC NOT IMPLEMENTED) 

X32 = 501 
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# Status code (502) indicating that the HTTP server received an 

# invalid response from a server it consulted when acting as a 

# proxy or gateway. (SCBADGATEWAY) 

X33 - 502 

# Status code (503) indicating that the HTTP server is 

# temporarily overloaded, and unable to handle the request (SCSERVICEUNAVAILABLE) 
X34 = 503 

# Status code (504) indicating that the server did not receive 

# a timely response from the upstream server while acting as 

# a gateway or proxy. (SCGATEWAYTIMEOUT) 

X35 = 504 

# Status code (505) indicating that the server does not support 

# or refuses to support the HTTP protocol version that was used 

# in the request message. (SC_HTTP_VERSION_NOT_SUPPORTED) 

X36 - 505 

# Error code in server. dispatcher.Dispatcher 

# D104 = Error in Dispatcher.doPostO 

# Dl 1 0 = Fragment Type not Specified or incorrect 

# P101 = Error in Dispatcher. putParseRequest() 

# VI 01 = Error validating user 

# Error codes in server.Fragment 

# F100 = Error in Fragment.fragment2XML() 

# F101 = Error opening Fragment.XML2fragmentO 

# F102 = Error parsing XML file in Fragment.XML2fragment() 

# F103 = Error calling readNode("+element+") 

# F104 = Error calling getElement Value 

# F105 = Error calling getElementType 

# F120 = Cannot close StringWriter 

# Error codes in server. TextUtils 

# R101 = Error in TextFiIe.read("+filename+") 

# R112 = Error in TextFile.readTextFileWOException("+filename+ M ) 

# R102 = Error in TextUtils.createDOMfromFile("+xmlflle+") 
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# R103 = TextUtiis.createDomFromFile SAX exception 

# R105 = TextUtiis.createDomFromFile 10 exception 

# Rl 12 = Error in TextFi le. readTextFil e WO Except ion("+filename+") 



# Error codes in server.dispatcher.DomUtils 

# D101 = DomUtils.documentToTuniverse TXDOM Exception 

# Dl 1 1 = Error in DomUtils.documentToUniversal 

# D123 = Missing or invalid sessionID on checkin 

# Error codes in server. dispatcher.Users 

# these have destination ERROR USER 

#U101= User + username + not defined 

# U102 = Wrong password for user + username 

# U103 = User with sessionid + sessionld + not defined 

# this has destination ERROR_LOG 

# Ul 10 = Users.methodname IO exception 

# Error codes in server.dispatcher. checkin 

# CI 03 = Error in document2 String 

# CI 02 = Checkin Error 

# CI 01 = Users. checkProvledge error 

# DEI 11 = Delete Error 

# G200 = successful get 

# P200 = successful put 

# Locking errors 

# LI 01 = Lock tokens do not match 

# LI 02 = missing lock token 



#MISC 

# F108 = invalid FragmentID 

# CI 23 = error in fragment2XML 

# CI 24 = Failed saving content to metadata store 

# G104 = Authorization String Empty 

# D145 = error parsing input stream 



Evaluation of Franklin and Kittyhawk Integration Concept 

pZT^eZarios to assess the value of an integrated ve./on ^ and FmrUn fitar. 
Afier you compete each scenario, please answer the corresponding questions. 

In your assessment of the value of the Franklin concept, t^?^*^* ^aluTo'f 
and bugs in this pilot implementation. Try to assess the value of the concept rather than the of 

this current implementation. 

Use the role Editor in FranklinRole fie/d in your user profile. To create projects and assign tasks, you 
need to be assigned the Kittyhawk role Administrator. 

Not e ft, for Scenarios i-3 you are ft. ro/e ofo ForS^s 

4-5. 

I called these A, B, C etc. Just to distinguish from existing ones. They should be renumbered 1,2,3 after 
we decide which ones to go with I think. 

Scenario A: Create and Publish reusable image and thumnail fragments 

pages Other editors will be able to search and use them in their pages. Create at least oj 
See the definitions of IMAGE and THUMBNAIL at 

[Here we should give the Franklin steps that start as a Superuser and create and publish a fragment 
each other, does that make sense?] 

Scenario ft Assign and Compete a "Create ana" Publish" Task for a Product Spec 

fragment . 

Set Superuser to "No" and Franklin Role to "Editor in KH 
Assume that Enterprise Sites need to host Product information on the 
line. This work needs to be delegated to an editor responsible for crea 
See the definition of PRODUCT SPEC at //cc > 0 nTn< 
hn p-llfranklin nHtechinterneti b ™ mm /franklin I downloads! I ESiteDTDs 

[This would be essentially Scenario I tailored to a Product Spec] 

Scenario C: Assign and Complete a "Create and Publish" T< 

Set Superuser to "No" and Franklin Role to "Editor" in KH 




Assume that Enterprise Sites needs to host a series of pages on the latest model in the ThinkPad line. 
The product spec, images and thumbnails have been uploaded earlier, now the tasks of creating and 
publishing a Product Page for the new ThinkPad need to be delegated to an Esite editor. This page is to 
be published for the web only. 

See the definition of PRODUCT PAGE and PRODUCT COMPARISON at 
http:lifrankl\n.adtech.internet.ibm.comlfranklmldown^ 

[this would be scenario 2 done once for PRODUCT PAGE] 

[questions afterwards would emphasize that product spec, image and thumbnail in first two scenarios 
were reused and did not have to be recreated] 

Scenario D: Assign and Complete a "Create" task and a "Publish" Task for a Product 
Comparison 

Set Superuser to "No" and Franklin Role to "Editor" in KH 

Assume that Enterprise Sites needs to host a page compariong the latest model in the ThinkPad line 

with older models to highlight it's advantages. The product spec, images and thumbnails have been 

uploaded earlier, now the task of creating a Product Comparison needs to be delegated to an Esite 

editor and the task of reviewing the work and publishing it to a QA person. This page should be 

published for the web only. 

See the definition of PRODUCT COMPARISON at 

hnp:llfranklin.adtechjnternetjbmxom/franklinldownloads//ES 

[this would be scenario 2 done once for PRODUCT COMPARISON but with separate tasks for Create 
and Publish] 

[questions afterwards would emphasize that product spec, image and thumbnail in first two scenarios 
were reused and did not have to be recreated] 

Scenario £; Assign and Complete a "Edit and Publish 9 ' Task for a Product Page 

Set Superuser to "No" and Franklin Role to "Editor" in KH 

Assume that: The Product Page on the latest ThinkPad created in Scenario C needs to be published for 
customers with a PDA and a notification sent to customers with Smart Phones. This task needs to be 
delegated to an Esite editor. 

See the definition of PRODUCT PAGE and PUBLISHINFO at 
hnp:Ilfranklin.adtechjnternetjbm.comlfranklinld 

[this would be scenario 2 done once for PRODUCT PAGE this time with Edit+Pubtish task] 
[questions afterwards would asl about the overhead of publishing for PDA and phone. 

Scenario F: Identify a problem on the Esites web sites and request that it be fixed 

Set Superuser to "Yes" and Franklin Role to "Editor" in KH 

Assume that While browsing the Esite, you see a bad typo on the Product Page created in Scenario C. 
As a Superuser, you bring the page into Franklin, fix the typo, republish, and verify that all affected 
pages were republished. 



See the definition of PRODUCTSPEC at 
hnp:/ffranklin.adtech.internetibm.com/franklin/downloads 



[this would be a brand new scenario where user starts by browsing Esites, sees a problem, copies and 
pastes the URL into Franklin File-> Retreive by Publish URL, checks out the page, checks out the 
imbedded PRODUCT SPEC subfragment, fixes the typo, checks in, reviews all affected pages, 
republishes the PRODUCT SPEC, and then goes back to Esites to see that the page has changed. 
I can write the step for this one because it includes some new funcationality that you may not have 
tried yet] 



Scenario I: Assign and Complete a "Create and Publish" Task for a Fragment 

[this would be incorporated into A and B] 



# Steps 

I KittyHawk Steps: Use Administrator Role 

1. Create a Request 

2. Create a Project and associate the Request 
to it 

3. Create a CREATE AND PUBLISH task 



Expected Results 
L A new task with Status "Sent" should be in 
the task section on the project 
2. Check that the task is in the KittyHawk 
editor queue. 



4. ASSIGN the task to a Franklin Editor with 
Regular User role (Note: Assign the task to 
yourself so you can complete it using Franklin 
Editor) 

5. Provide a DESCRIPTION of the document 
to be created 

6. Designate a DTD name (e.g. Thumbnail, 
Form, Product Spec, or Form) 

7. SEND the task 

8. Save and close the task, and project 

2 Franklin steps: Use regular Franklin User 

(Editor) role I. In Franklin, after publish, fragment should 

1. Launch the Franklin Ul and Login disappear from the Active List 

2. Get tasks assigned to you 

3. Start the task to create the appropriate 
fragment, fill it in , and check it in 

4. Approve the final pages (and note that 
there are no pages to approve because no 
servable page includes the fragment you just 
created) 

5. Publish the fragment 

3 KittyHawk Steps: Use Administrator Role I. Task should have Status "Comp". 

2. Fragment ID should be filled in for the task. 



/. Open the project with previously assigned 
task 

2. Click Refresh button above Task Section 



View task in Project form. Since all tasks on 
the project are complete, you can now click the 
Begin Final Approval process button. 



3. 'URLs of work' field should be filled on the 
project form. (If fragment is not used in any 
servable pages yet, the message should say 
"No URLs to view. This fragment is not used in 
any final page") 

4. Check that the task is no longer in the 
KittyHawk editor queue. 

Requesters will be notified that the work has 
been complete. 



Scenario I Questions: 

How satisfied are you with the KittyhawklFranklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the current 
method/tool you use? Kittyhawk/Franklin is. . . 
Much Worse Worse About the Better Much Better N/A 

Same 

1 2 3 4 5 

Please explain. 



Scenario 2: Assign and Complete a "Create and Publish" Task for a Servable Page, 

use Save as Draft in Franklin 

[this would be replaced and incorporated into C] 

Repeat the same steps used in Scenario I, only this time create a servable page by selecting one of 
the following: promotion, productpage, productcomparison or link. 

All other steps are the same as in Scenario /, except* 

# Steps Expected Results 

2 Franklin steps: Use regular Franklin User I. Saving as Draft should update the 

(Editor) role "Create+Publish" Task with the fragmentID 

L Launch the Franklin Ul and Login 

2. Get tasks assigned to you 

3. Verify that the "Create+Publish" task has 
no FRAGMENTID associated with it 

4. Start the task to create the appropriate 
servable document 

5. Search for subfragments to include in the 
document 

6. Cut and paste the desired fragments into 
the document 

7. Select style sheets for the web, the pda, and 
the Slingshot index page. 

8. Preview your work in between edits 

9. Complete filling in the document 

1 0. Check in the document as a DRAFT 
I I. Remove it from the Active L/st 

12. Refresh tasks assigned to you 

13. Verify that the "Create+Publish" task now 
has a FRAGMENTID associated with it 

14. Start the task again 

15. Make further edits 

16. Check document in 

1 7. Verify that document appears highlighted 
in Active Ust 

1 8. Approve final pages 

19. Publish document 



Scenario 2 Questions: 

How satisfied are you with the Kittyhawk/Franklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does Kittyhawk/Franklin compare to the current 
method/tool you use? Kittyhawk/Franklin is. . . 
Mudi Worse Worse About the Better Much Better N/A 

Same 

1 2 3 4 5 

Please explain. 



Scenario 3: Copy and Paste Fragments from Franklin into a Kittyhawk Project 

[this would stay as is] 
# Steps Expected Results 

1 Log into Franklin. 

2 Click on the search button in left panel. 
Give query parameters, and search for a 
list of Fragments. 

3 Select several fragments. Click copy Copies fragment information to clipboard, 
button. 

4 Open KittyHawk. Open an existing 
project, or create a new project. 

5 Click PASTE FROM FRANKLIN button. Creates a task for each fragment 

Scenario 3 Questions: 

How satisfied are you with the Kittyhawk/Franklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does Kittyhawk/Franklin compare to the current 
methodltool you use? Kittyhawk/Franklin is. . . 
Much Worse Worse About the Better Much Better N/A 

Same 

1 2 3 4 5 

Please explain. 



documents in Franklin 

Expected Results 



Scenario 4: Search and try to check out 
[this would stay as is] 

# Steps 

1 Log into Franklin. 

2 Click on the search button in left panel. 
Try out different combinations of search 
attributes, operators and values. Verify 
results. 

3 Select a document in the Search results 
and try to check it out. 

4 Select a document in the Search results 
and check out for view only. 

5. Try to check in document displays in right 
hand panel 

6 Try to check out document displayed in 

right hand panel. 
7. Remove document displayed in the right 
hand panel from the Franklin Editor 



Check out icon should be disabled. 

Document should appear in Right panel in Read 
only mode. 

Check in icon should be disabled. 

You should not be able to check it out, as it has not 
been assigned in a task to you.. 



Scenario 4 Questions: 

How satisfied are you with the Kittyhawk/Franklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does Kittyhawk/Franklin compare to the current 
methodltooi you use? KittyhawklFrankiin is. .. 
Much Worse Worse About the Better Much Better N/A 

Same 

1 2 3 4 . 5 

Please explain. 



Scenario 5: Assign and Complete an "Edit" task and a "Publish" task for a 
Promotion 

[this would be replaced and incroporated into Scenario D because it >s two separate tasks, and 
Scenario E because it's an Edit, not a Create] 



# Steps 
I KittyHawk Steps: Use Administrator Role 

1. Create a Request 

2. Create a Project and associate the request 
with it 

3. initiate a task to EDIT a Promotion 
servable 

4. Click on SEARCH FRANKUN button to get 
a fragment ID from Franklin 

5. ASSIGN the task to a Franklin Editor with 
Regular User role (yourself in this case) 

6. Send the task 

7. Save and close task 

8. Initiate a task to PUBLISH the same 
Promotion servable 

9. ASSIGN the task to a Franklin Editor 
(yourself so that you can complete the task - 
in reality you would assign it to a different 
person than the previous EDIT task) 

1 0. Close task without sending. 

1 1. Close the project 

2 Franklin steps: Use regular Franklin User 
(Editor) role 

I Launch the Franklin Ul and Login 

2. Se/ect Tasks -> SHOW TASK INTERFACE, 
and view tasks assigned to you 

3. Start the task to check-out the Promotion. 

3. Edit the Promotion and check it in 

4. Select SHOW TASK INTERFACE to verify 
that task has disappeared. 

3 KittyHawk Steps: Use Administrator Role 

J. Open the project with previously assigned 
task. 

2. Click Refresh button above Task Section. 

3. Edit the PUBLISH task, send it, and close 
task. 

4. Franklin steps: Use regular Franklin User 
(Editor) role 



I. Select Tasks -> SHOW TASK INTERFACE, 
and view tasks assigned to you 



Expected Results 

1. A new EDIT task with Status "Sent" should 
be in the task section 

2. A new PUBLISH task with Status "New" 
should be in the task section 

2. Check that the EDIT task is in the 
KittyHawk editor queue 



1. In Franklin, the Promotion appears 
highlighted in Act/Ve List. 

2. The Check-out, Approve and Publish icons 
should be disabled for the Promotion, as you 
have not been assigned the PUBLISH task at 
this point 

3. Task should not appear in Task Interface 
anymore. 

1. EDIT task should have Status "Comp". 

2. 'URL of work' field should NOT be filled for 
the EDIT task on the project form. 

3. Check that the EDIT task is no longer in the 
KITTYHAWK editor queue. 

4 PUBLISH task should have Status "Sent" 
L Starting the PUBLISH task should launch 
the hrnwser with links to all finaljpagestg — 



preview. 



2. Start PUBLISH task to begin approval of 
final pages. 

"3^Review^ll^ages-in~the-browser 

4. Publish the Promotion 

5. Exit Franklin Editor 

KittyHawk Steps: Use Administrator Role 

1. Open the project with previously assigned 
task 

2. Verify that all tasks are complete 

3. Click on "Begin Final Approval" 

4. Copy and paste appropriate URLs of work 
to Request document 



1. PUBLISH task should have Status "Comp". 

2. 'URL of work' field should be filled in for the 
PUBLISH task on the project form. 

3. Check that PUBLISH task is no longer in the 
KITTYHAWK editor queue. 



Scenario 5 Questions: 

How satisfied are you with the Kittyhawk/Franklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does Kittyhawk/Franklin compare to the current 
method/tool you use? Kittyhawk/Franklin is. 
Much Worse Worse About the Better Much Better M/A 

Same 

1 2 3 4 5 

Please explain. 



Scenario 6: Assign a "Publish" Task, Create and Address Problem Report 
f we could include the creation of a problem report in the "publish" part for Scenario D 
or should we leave it as a separate scenario as is so that the scnarios are shorter and 
address fewer functionalities? What do you think?] 

instead of creating an "Create" task for this one, assume that a product page has already been 
created. 



# Steps 

1 KittyHawk Steps: Use Administrator Role 
I. Open an existing project 

3. Initiate a task to PUBLISH a Product Page 
servable 

4. Click on SEARCH FRANKLIN button to get 
a fragment ID from Franklin 

4. ASSIGN the task to a Franklin Editor with 
Regular User role (yourself in this case) 

5. Send the task 

6. Save and close task, and project 

2 Franklin steps: Use regular Franklin User 
(Editor) role 

1. Launch the Franklin Ul and Login 

2. Select Tasks -> SHOW TASK INTERFACE, 
and view tasks assigned to you 

3. Start PUBLISH task to begin approval of 
final pages. 

4. Review pages in the browser 

5. Create a problem report for the web 
document 

6. Double click on one of the product data 
elements in the table. 

7 R/ j in PROBLEM REPORT and send. 

8. Close the browser 

9. Remove Product Page with problem from 
your Active List 

10. Verify that the PUBLISH task still appears 
in our Task interface. 

3 KittyHawk Steps: Use Administrator Role 
L Open the project with previously assigned 
task. 

2. View the Problem Report 

3. Assign a new "Edit and Publish" task with 
fragmentid from Problem Report (assign it to 
yourself) and the problem stated 

4. Franklin Steps: Use regular Franklin User 

(Editor) role to complete the "Edit and Publish'' 
task as usual 



Expected Results 
LA new PUBLISH task with Status "Sent" 
should be in the task section 
2. Check that the task is in the KittyHawk 
editor queue 



1. Starting the PUBLISH task should launch the 
browser with links to all final pages to preview. 

2. After clicking on "Create Problem Report", 
you should see the fragmentid and element 
name change in the browser status bar as you 
mouse over the different areas of the page. 

3. Double-clicking on an area should launch a 
Problem Report form to fill in. 

4. In KittyHawk, task should still appear as 
"Sent" as it was never completed due to 
problem. 



I. Problem Report should appear in the 
Project 



KittyHawk Steps: Use Administrator Role 
/. Refresh task list 

2. Note that "Edit and Publish" task is 
completed 

3. Edit the "Publish" task still uncompleted due 
to Problem Report 

4. Reclick on SEND to resend the task to the 
same editor (to notify him that problem has 
been corrected) 

Franklin Steps: Use regular Franklin User 
(Editor) role to complete the "Publish" task as 
usual. 



I. When approving final pages, the cause of the 
Problem Report should be fixed. 



Scenario 6 Questions: . . 

How satisfied are you with the KittyhawklFrankiin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does KittyhawklFrankiin compare to the current 
method/tool you use? KittyhawklFrankiin is. .. 
Much Worse Worse About the Better Much Better 

Same 

1 2 3 4 5 

Please explain. 



Scenario 7: Create a Superuser Activity Log and View Conflict Reports as 
Superuser 

[this would stay as is also] 

Change your Superuser flag to "Yes" in your KittyHawk User Profile 



# Steps 

/ Open KittyHawk. Create a project 

2 Assign several EDIT tasks associated with one 
Fragment ID. 

3 Assign all to regular Franklin role editors. 

4 Send Tasks, Save Project, and close 
KittyHawk. 

5 Franklin Steps as a Superuser: 

1. Launch Franklin Editor 

2. Select (t File->Check out by Fragmentid" to 
check out the FragmentID that you assigned 
to other editors in Step 2 

3. View tasks assigned to other editors for the 
document in the Conflict Report 

4. Click on "OK" to check out anyway 

5. Edit the document 

6. Check it in and view the Conflict Report 
again. 

7. Click on "OK" to check in anyway. 

6. KittyHawk Steps: as Project Administrator 

1. Open the project navigator. 

2. Open the project 

3. Click on the doclink. 



Expected Results 



/. Conflict report should warn user of other 
active tasks on the same fragment 



L There is a lightning bolt icon in the view to 
indicate that there was 'superuser activity' on 
one of the tasks related to the project 

2. There is a doclink in the Superuser Activity 
field. The history on the project also indicates 
that there was superuser activity on the project 

3. The superuser activity log is opened. 



7 As a regular editor, check out a fragment that 
is in a task not assigned to you. 

8 As a Superuser, check out a fragment that is 
not assigned in the other tasks. 



9 Edit fragment and check it in. 

10 Repeat test by assigning tasks to other 
Franklin roles in KittyHawk: Image Editor, 
Fragment Editor. 



Not allowed because the user cannot see 
them. 

The fragment is checked out without any 
warnings. 

The Conflict Report will not appear at check 

out or check in of this fragment until it is 

assigned to a task. 

A superuser activity log is created in 

Kittyhawk. 



Scenario 7 Questions: 

How satisfied are you with the Kittyhawk/Franklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does Kittyhawk/Franklin compare to the current 
method/tool you use? Kittyhawk/Franklin is. . . 
Much Worse Worse About the Better Much Better N/A 

Same 

1 2 3 4 5 

Please explain. 



Note that for Scenarios 8-9 you are playing the role of a Superuser. Before beginning, make sure your 
Franklin role is KittyHawk User profile is set to ''Editor" and Superuser to "Yes. 

For the pilot we are using 3 Enterprise Sites: Cargill, North Carolina, and Bayer. You must register to 
each one separately, with a different user name, because die registrations cannot be shared between 
different E-Sites. (If you choose to register only at one, make sure you publish content to that E-Site in 
the Scenarios below) 



Scenario 8: Register with the Enterprise Sites, publish and view a Product Comparison 
at an E-S/te. 

[this scenario should come earlier, so that they register to Esites, maybe should be after 
Scenarios A and B, the first time they have to actually publish a servable page, not just a 
fragment. I think this should be changed to be A PROMOTION instead of Product 
Comparison because we already have a Product Comparison in Scenario D... 

J 



# Steps 
I E-S/te registration steps: 

1. To register, go to 

http ://amadeus .sby .ibm.com/servlet/gold/NorthCarol ina/We lcome 

2. Click on "Register Now". 



Expected Results 
After logging on to one E-Site, your browser is 
set with a cookie for that particular E-S/te. The 
cookie lasts for the current browser session. 
To register or logon to a different E-S/te, you 
need to launch a new browser and go to die 
URL of that site. The 3 E-Site URLs are: 



3. Follow instructions to register until you are 
brought back to the Login screen of the 
Enterprise Site you started from. 

4. Enter the IBM ID and password you just 
created, 

5. When prompted for the IBM authorization 
code, enter "ncl 00" (You will receive this code 
in an e-mail at some point, this gets you 
started faster) 

6. On the home page of the E-Site, click on 
"Edit Personalization" 

7. Select a Job Type and Check ALL available 
options (to ensure that regardless of interest 
area classification of a document, it will appear 
for you) 

8. Click on "Submit", then click on "Return to 
your IBM home" 

9. Note the different sections of the site: 
Home, Product, News, Solutions, etc 

1 0. Close the browser 



ht^;//amadeus.sby.ibm.conVservlet/gold/NorthCarolinaAVelcome 
http://amadeus.sby.ibm.com/servlet/gold/CargillAVelcome 
http://amadeus.sby.ibm.com/servlet/gold/Bayer/Welcome 



/ /. Launch a new browser and repeat steps 
I -10 for the other 2 Enterprise Sites: 

http://amadeus.sby.ibm.corn/servlet/gold/Cargill/Welcome 
http://amadeus.sby.ibm.com/servlet/gold/Bayer/Welcome 

Franklin steps: 

L Launch the Franklin Ul and Login. 

2. Create a Product Comparison. To ensure 
that you will see the document on the E-Site 
under your profile: 

• enter STARTJDATE as today or earlier to 
make the article appear immediately 

• select one or more ENTERPISE Sites you 
want it to appear under 

• select the LOCATION, or the section of the 
site you want it to appear under 

• select a few INTEREST J^REAS 

• do not select H0ME_FEATURE (it is not 
working for now) 

• select the JOBJTYPE you set in your E-Site 
profile or "All" 

3. Search for Product Specs and Thumbnails 
and include one of each in the Product 
Comparison using Copy and Paste. 



4. Create a newThinkPad Product Spec (to 
include as the second product in the Product 
Comparison) and check it in. 

5. Copy and Paste the new Product Spec from 
the Active Ust to the Product Comparison. 

6. Preview the horizontal and vertical style 
sheets and select the one you prefer. 

7. Check in the Product Comparison. 



8. Check out the unpublished subfragment 
using the small check out icon to the right of it 
in the Product Comparison. 

9. Check the fragment back in, then publish it 
from the Active List 

1 0. Try to check in the Product Comparison 
again. 

1 1. Approve the final pages for the Product 
Comparison. 

12. Publish the Product Comparison. 

3. Enterprise Site steps: 

1. Logon to one of the E-sites where you 
published the Product Comparison. 

2. Go to the section you selected under Step 2 
for LOCATION. 

3. Locate the Product Comparison and view the 
document 

4. Franklin steps: 

1. Search and check out the Product 
Comparison 

2. Change the LOCATION tag. 

3. Check in the Product Comparison. 

4. Publish the Product Comparison. 

5. Enterperise Site steps: 

1. Go to the section that corresponds to the 
new LOCATION you specified in Step 4. 

2. Refresh the page in the browser. 

3. Locate the Product Comparison. 
.6. Franklin steps: 

1. Check out the Product Spec you created in 
Step 2.4. 

2. Edit the PRICE__DOLLARS field. 

3. Check it in, and Publish. 
7. Enterprise Site steps: 

I. Locate the Product Comparison. 



When trying to check in the Product 
Comparison, a dialogue should alert you that a 
subfragment has not been published. 



When trying to check in the Product 
Comparison, no dialogue should pop up this 
time. 



Product Comparison should not appear under 
old LOCATION, and should now appear under 
new LOCATION. There may be a slight delay, 
so try a few times if you do not see the change 
immediately. 



The republish of the Product Spec should have 
triggered the republish of the Product 



2. Refresh the page. 

3. Verify that it reflects the updated price. 



Comparison. There may be a slight delay, so 
try a few times if you do not see the change 
immediately. 



Scenario 8 Questions: 

How satisfied are you with the Kittyhawk/Franklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does Kittyhawk/Franklin compare to the current 
method/tool you use? Kittyhawk/Franklin is. . . 
Much Worse Worse About the Better Much Better N/A 

Same 

1 2 3 4 5 

Please explain. 



Scenario 9: Verify the locking of documents in Franklin 

[this should stay as is] 

Complete this scenario with a collaegue, both of you as Superuser. 

# Steps Expected Results 

I Franklin steps: Document appears in right hand panel. 

User I: 

1. Launch Franklin Editor. 

2. Search for a document of your choice. 

3. Check it out 



User 2: 

1. Launch Franklin Editor. 

2. Search for the same document as User I in 
Step I. 

3. Check it out 



You should get a dialogue stating that the 
document is locked by User I. Choose to check 
it out for "Read only". 



3 



User I: 

I. Remove the document from the right hand 
panel. 



Document is highlighted in Active List, but no 
longer checked out 



User 2; 

/. Check out the document in the right hand 
panel 

User I & 2; 

Exit Franklin Editor. 



You should not get the lock message, and 
document should check out 



Scenario 9 Questions: 

How satisfied are you with the Kittyhawk/Franklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does Kittyhawk/Franklin compare to the current 
method/tool you use? Kitty hawk! Franklin is. . . 
Much Worse Worse About the Better Much Better N/A 

Same 

1 2 3.4 5 

Please explain. 
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How to Install Franklin Editor 



1 . Create a franklin directory in a location of your choice on your hard drive. These instruction assume 
you create C:\franklin\ 

2. Download the self-extracting FranklinEditor from 

http://monolith.adtech.intemet.ibm Save the file to a 

temporary directory on you hard drive. 

3. Double-click on FranklinEditor.exe in the temp directory on you hard drive. This will start the 
WinZip Self-Extractor. Under "Unzip to folder" enter C:\franklin\ or the path to the franklin directory 
you created in Step 1. Click on "Unzip". 

4. Go to C:\franklin\FranklinEditor on your hard drive. Open franklin. properties file inNbtePad. If 
the location of your browser is different from the one listed, remove the # in front of browser? a th and 
change the value to the appropriate path on your machine. Save and close the file. 

5. Double-click on C:\franklin\FranklinEditor\FranklinEditor.bat file. The login screen will popup 
and prompt for your username and password which the Franklin team has provided to you. 



How to Delete Franklin Editor 



1 . Simply delete the franklin directory you created on your hard drive. 
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How to Get Started with Franklin Editor 

After installing the Editor by following the How To Install instructions and logging in, you can take the 
actions listed below. When Franklin runs integrated with the Kitty Hawk workflow engine, a user can 
work in one of two modes: superuser or regular user . 

Note: 

All icons in the Editor UI display a tooltip if you mouse over the icon. 
Useful error messages appear in the status bar at the bottom of the Editor UI. 

ACTIONS FOR SUPERUSER 

^Search 

Click on the "Search" icon above the Active List. This brings up the Search UI. Select attributes and 
values from the drop down menus. You can add more search conditions using the +/- widget. Click on 
"Submit" to launch the search. 

Hint: A search that will always bring back results is "Page Type is Fragment" 

Once search results are displayed in the table, you can select one or more of them and merge them into 
the Active List in the Editor UI by clicking on the "Merge with Active List" icon 

ill 



IslCheck Out for Edit 

Select an item in the Active List and click on the "Checkout selected document" icon. If the document is 
not locked by another user, it will appear in the right-hand pane in editable widgets. You can modify any 
fields and resubmit into Franklin server. See "Check in" 

IMcheck Out for View 

Select an item in the Active List and click on the "View selected document in read only mode" icon. It 
will be displayed in the right-hand page in editable widgets. However, you will not be able to check-it in 
with any changes. You can click on the "Check out" icon above the right-hand pane to check it out for 
edit. 



Ucreate New Fragment 

Click on the "Create new document" icon. This brings up the list of fragments and pages you are 
allowed to create. Select a fragment, click on "Create". The Editor UI retrieves the correspondig DTD 
from the server and auto-generates the right-hand pane with widgets. The required fields are highlighted 
in yellow, and must be filled in before you are allowed to check in the document. 



L3 



Create a New Page 



Create a page the same way you create a fragment. However, note that a page has additional fields that 
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enable it to be turned into a final HTML page and previewed: 



A page includes one or more subfragments. To include a subfragment into a page under construction, 
do the following: 

• Search for all subfragments of the appropriate document type (see Search), and merge them into your 
Active List 

• Select the subfragment you wish to include from the Active List 

• Click on the "Copy" icon above the Active List (3l 

• Click on the subfragment field in the page under construction 

• Click on the "Paste" icon above the right hand pane. Ili) This will write the fragment ID of the pasted 
fragment into the field. 



A page requires "Publishlnfo" to be filled in. You must select a publish directory on the server. This 
is where the final page will be saved. You must also enter the final HTML file name for the published 
page. You must also select a style sheet to render the page in HTML. 



See "Preview" to view the final HTML page. 
Check in 




Once you have created a new document or modified an existing one, click on the "Check in document" 
above the right-hand pane. The document will be validated against the DTD and sent to the Franklin 
server. You can now search for it to check it out again for modifications. 

Preview a Page 



Before checking in a page, you can preview it by clicking on the "Preview page" icon above the right- 
hand pane. It will launch the browser you specified in the franklimproperties file during installation. The 
browser will display the output HTML generated using the style sheet listed in the first PUBLISHINFO 
of the page. To see all output pages, you need to check-in the page and then click on the "Approve" 
icon. 



Note that you can make further changes to the page and preview it again before checking it into the 
server. You can also preview any page (but not a fragment) by selecting it from the Active List and 
clicking on the "Preview page" button above the Active List. 




'Approve document 



To approve the publishing of a fragment or a servable, select it in the Active List and click on the 
"Approve final pages for selected document" icon. This will launch a browser and display a list of all 
resulting HTML pages. For a fragment, the list consists of all final HTML pages of all the servables that 
include the fragment as a subfragment. For a servable, the list consists of all final HTML pages of that 
servable. 



zJCreate problem report 

If you find a problem with a final page, create the appropriate problem report by clicking on the "Create 
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problem report" icon. 
liJpublish document 

If you find no problems with any of the final pages you are approving, click on the "Publish document" 
icon above the Active List. The selected document will be published to the server. 



'Remove current document 



While editing a document in the right-hand pane, you can click on the "Remove current document" icon. 
This will unlock the document on the server and discard the document being edited from the Editor UL 



ACTIONS FOR REGULAR USER 



Get Task List 



Select "Tasks -> Show Task Interface" from the menu bar to retrieve current tasks assigned to you in the 
workflow engine. 

Iftlupdate Task List 

To refresh the entries in the Task Dialogue, click on the "Update task list" icon. Note that after you first 
launch the Task Dialogue the tasks do not get automatically updated. You have to explicitly ask for the 
list to be updated. 




■Initiate Task 



To begin working on an assigned task, select the task and click on the "Initiate selected task" icon. A 
Create task will open a new document template to fill in, an Edit task will check out an existing 
document, and a Publish task will launch a browser to approve pages to be published. Once you check- 
in or publish the document initiated by a task, the task will disappear from the task dialogue. 

[^Iview task info 



To view task associated with a document in the Active List or in the right hand panel, click on the "View 
task associated with selected document" icon. It will bring up the Task Dialogue with the appropriate 
task selected. Note that this icon is only enabled for documents that are associated with a task. 



The other actions you will be able to take in the Franklin Editor UI as a regular editor are described 
above in the superuser section . Allowed actions will be identified by the icons being highlighted. 



Franklin User Acceptance Testing 

Participant Feedback Analyzed for the Franklin Team by 
Roger Tilson 

IBM Ease of Use Architecture and Design 
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Executive Summary 

Participants generally liked the functionality that Franklin provided, and they were generally satisfied 
with the tool overall. Participants liked that Franklin 

♦ Publishes data in as many different formats as desired 

♦ Solves the problem of data maintenance on the Web 

♦ Stores product data in XML 

♦ Provides the ability to publish content without help from developers 

♦ Provides the ability to change content once and have the changes appear in multiple places 

♦ Provides the ability to convert product data to non-Web platforms 

♦ Provides the ability to preview 

♦ Allows sharing of fragments 

♦ Provides better organization of content/data via standardization 

♦ Allows the user to click around the site and easily change the page 

♦ Allows the user to retrieve documents based on URL 

In addition to these generally positive comments, participants noted areas for improvement In 
particular, participants expressed dislike for the current Ul, or what they called "getting around" in it 
They recommended, either explicitly or implicitly, several minor changes, such as right<lick options, 
double clicking to open/checkout documents, keyboard shortcuts for copy and paste, a more 
conspicuous icon for the search interface, and a way to sort lists of items in the search interface by 
clicking on headers. They also recommended or implied that some major changes would be valuable. 
Specifically, participants suggested enabling users to browse the Web and identify/select servables and 
fragments for editing, and creating a browsable library (distinct from the search interface) of fragments 
and servables that also enables previewing. 

The Franklin team needs to implement the minor changes participants recommended, and also 
consider some of the major changes. The magnitude of the Ul design changes the team undertakes will 
likely depend upon the goals/ requirements for Franklin. If the goal is for users to be as efficient as they 
can be using Franklin, and to learn it as quickly as possible, then the Franklin team needs to gather 
more user input to determine the optimal Ul design for interacting with servables and fragments. If the 
goal is only for users to be more efficient than they are currently, then several minor changes to the Ul 
will likely suffice. The usability goals for Franklin will dictate whether more user input and major design 
changes are necessary. 

Recommendations 

The most important recommendation involves completing a design walkthrough. The specific 
recommendations for improving the Ul appear in two categories, one for major design changes, and 
one for minor changes. 

Complete a design walkthrough or head-to-head comparison 

If the goal is for users of Franklin to be as efficient as they can be, then the Franklin team needs to 
complete a design walkthrough showing users different possible designs for finding and working with 
servables and fragments. Among these different possible designs would be those of the competition. 
The main goal of the walk through is to determine which design(s) works best Other goals are to 
determine if there is a reason or advantage in continuing to develop a new product, what those 
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advantages are, and whether the new product being considered needs changes to the conceptual 
design. The different designs used can be paper sketches, screen mockups, or a fully functional tool like 
Franklin is currently. Whichever they are, participants "walk through" accomplishing particular tasks. 
See the UCD site for more information on design walkthroughs (w3.ibm.com/ucd). 

Consider the following major Ul changes: 

♦ Additional views (e.g. tree diagrams, or other mechanisms determined by user input) for finding, 
checking out, and previewing fragments and servables 

♦ A feature that allows users to browse the site and find the page/fragment they want, and then 
select and open it from the browser to edit it 

♦ A mechanism allowing users to organize servables and fragments according to their needs 

♦ A preview function in the search interface so users can determine if a fragment or servable is the 
one they want (perhaps previewing the selected fragment or servable in a right pane while the left 
shows the list of fragments or servables) 

Make as many of the following Ul changes as time and resources permit: 
° Provide a short tutorial explaining how to get started using Franklin 

a Give default focus to the user name field of the Franklin logon interface (also enable keyboard 
use to logon) 

D Provide easy-to-understand labels for fields in templates 

° When possible, change to standard Lotus or Microsoft icons, or icons that users are more 
familiar with 

D Use text labels with all icons or those icons that may be unfamiliar 

n Make it more obvious that the search button is active when Franklin first launches 

D Enable use of keyboard for all functionality, especially copying and pasting fragments 

n When users access the directory, open to the location users were last viewing 

a When the Franklin window is resized, adjust the size of option and entry fields so that the 

entire Ul fits into the window; establish a minimum size for entry fields, at which point 

horizontal scrolling is required 
° Do not close the draft when users click save as draft (not sure what all users expect save as 

draft to do, but one person recommended this, use extra discretion here) 
n Provide messages that not only tell users there is a problem, but tell users how to solve the 

problem 

_ D Provide messages to indicate why preview will not work in some situations 

° Provide localized help to explain the function of specific fields in templates, or a prominent link 

to a page showing examples of how the data is used 
D Indicate for all fields what information is and/or is not necessary (e.g. whether adding a $ sign 

is necessary in price fields, and whether adding the abbreviation MB is necessary for memory 

fields) 

a Indicate beside the name fields that users need to add file extensions such as .jpeg or .gif 
D Add right<lick functionality, such as for copying and pasting fragments, or checking out 
fragments and servables 

a Enable users to sort search results by creator, dates, etc., by clicking on the metadata headings 
a Ensure user ids and logins aren't case sensitive, and that users get the same search results 

when they type roger tilson or Roger Tilson as the creator 
a To check out fragments, allow users to type names in addition to copying and pasting them 
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D Facilitate double<licking to open/checkout documents and create new ones 

D Provide more cues in the search interface as to the status of use of fragments and servables: 

are they currently checked out, and are they currently published on the site 
0 Provide a way to publish to multiple servers 

Caveats 

This user input will be most valuable as a means to improve the Ul and functionality rather than as an 
assessment of the value of Franklin. It will not be very useful as an assessment of the value of Franklin 
for the following reasons: 

♦ At least two participants thought Franklin was for product data only, which caused them to rate 
Franklin lower on key scales 

♦ One participant did not realize that Franklin was intended to be used as part of a workflow 
process, and that they did not use this aspect of the product 

♦ The esites meta data was complex and foreign to this different group of users, which made the 
tasks difficult to complete 

♦ Participants reported that sometimes the instructions were not clear or contained irrelevant 
information, and most could not complete task 8 because the document was not checked out as 
was intended 

If the Franklin team still wants a proof-of-concept user evaluation, then Franklin will need to be 
customized to meet the specific needs of the user group that performs the evaluation. The scripts will 
also need to be pilot tested, since some of the instructions were inaccurate. 

Participants 

Four out of six of the participants currently create or maintain content for Web sites. The other two 
participants are involved in determining which tool(s) the TG group will use to create and manage Web 
content 

Findings 

Participants liked the functionality that Franklin provided. Specifically, they liked that it 

♦ Publishes data in as many different formats as desired 

♦ Solves the problem of data maintenance on the Web 

♦ Stores product data in XML 

♦** Provides the ability to publish content without help from developers 

♦ Provides the ability to change content once and have the changes appear in multiple places 

♦ Provides the ability to convert product data to non-Web platforms 

♦ Provides the ability to preview 

♦ Allows sharing of fragments (with other content providers? Or documents? Or both?) 

♦ Provides better organization content/data via standardization 

♦ Allows the user to click around the site and easily change the page 

♦ Allows the user to retrieve documents based on URL 

Below are the ratings for three of the post-test questions, and the comments of the participants: 
Overall satisfaction 



Franklin User Acceptance Testing 



5 



How satisfied are you overall with the Franklin process for completing these scenarios? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very 

Satisfied 

I 4 

Mean Avg: 3.8 (Between Neutral and Satisfied) 

Lynn (Neutral): I liked the way it captured the data and how that data could be used anywhere in as 
many different formats as someone wanted. Getting around the tool was difficult 

Michelle (Satisfied): I believe that Franklin is a good tool to complete a lot of the content management 
tasks. However, the main comment I have is that the instructions for the test are not clear, making it 
difficult for me to evaluate Franklin. The 30min orientation (given the down times) gives only a cursory 
view of the tool I would be able to give better feedback if I understand it more. 

Dave (Satisfied): Although not impressed in comparison to our other tools, Franklin is a good product It 
gets the job done, is fairly easy to use after being trained and learning how the Ul works, and solves a 
legitimate problem with data maintenance on the Web. 

Getting started 

How easy or difficult was it to get started using Franklin? 

Very Difficult Difficult Neither Difficult Easy Very Easy 

Nor Easy 

I I 3 

Mean Avg: 3.4 (Between Neither/Nor and Easy) 

Lynn (Neither/ Nor): When the login screen appears, the top text box should have a set focus on it 

Patty (Easy): The hardest part was understanding the meta data for the e-sites. 

Phyllis (Difficult): I did not know about the icons to the right of the screen (i.e. check out subfragment 
or add fields). 

I did not know that fragments or subfragments had to be 'merged' onto the active list in order to use 
them. 

Dave (Easy): It is not a difficult tool. There were frustrations at the beginning, however. For example, wanting to 
close the current document, and not finding where the close button was. (Closing the entire application instead.) 
Also, Copy and Paste did not seem to work, and other functions that are normally taken for granted in any 
production application. 

Do vou think Franklin needs to be easier to get started using? 
Lynn: Yes. There could be a tutorial provided. 
Patty: No 
Phyllis: Yes 

Michelle: Yes, An average user may not be well versed in "common" software navigation. Need more 
comprehensive training before use and continued support during use. Would be useful to have a help 
manual (local and Web). 
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Dave: Yes. Things as simple as using standard icons for dose, copy, paste, etc would be a great help. 
Although the tool is not hard to learn, the questions are screaming in my mind of why the programmers 
made up their own icons for copy/paste, among other things? 

Ease of using once learned 

How easy or difficult was using Franklin once you had learned how it worked? 

Very Difficult Difficult Ne/ther Difficult Easy Very Easy 

Nor Easy 

2 2 

Mean Avg: 4.5 (Between Easy and Very Easy) 

Phyllis (Very Easy): The tool was easy to use after I had received help from Dikran. In the future, the 
eMeeting should be allotted more time to ensure that the introduction may be completed. 

Michelle (Easy): Once you understand how it works, it's easy though there are little quirks here and 
there. 

Dave (Easy): As mentioned, the initial learning curve is quick, then the tool is easy to work with. The 
exception to this is the product page form, which is way too complex for the average user. 

Comparison with other tools 

How does Franklin compare to the current method/tool you use to manage the content of Web sites? . 
Franklin is. . . 

Much Worse About the Better Much Better N/A 

Worse Same 

2 3 

Mean Avg: 2 (Worse) 

Lynn (Worse): Worse than our new tool. We would have to set up extensive training on the Franklin 
tool and then dedicate resources to be a pseudo help desk. 

Dave (Worse): Although Franklin has some added features, it is missing many more. It seems to be 
' more a tool to just manage the XML for product data than for true content management Also, the Ul 
features need quite a bit of work to make the tool workable for most. users. If Franklin could be 
integrated as a part of a complete content management system, it would add a good deal of value. 

Task efficiency 

Tasks users can complete more efficiently using Franklin: 

Lynn: Viewing data under different environments, Storage of XML data 

Phyllis: The ability to publish content without help from developers 

The ability to change content once even though it is located in multiple places 

Dave: Product Spec sheets, conversion of product data to non-Web platforms 
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Tasks users can complete more efficiently using other tools: 

Lynn: Our tasks are easier to perform. Our new tool will have the ability to modify non-product data. 
Phyllis: None 

In general, would Franklin allow you to complete your tasks more efficiently : 

Lynn: Franklin would allow our team to perform a fraction of our tasks more efficiently. We still have 

the overview page, news, support, press releases and a few other templates. 

Phyllis: Yes. It will reduce the need for help from developers. Content will, consequently, be updated or 
modified more frequently. 

Dave: No. Most of IBM does not have a robust content management tool, and would get great value 
from Franklin. However, PSD has a tool already, and is developing the next generation of that tool. The 
ideal solution would be to integrate the strengths of Franklin with the rest of their tool. 

Franklin advantages 

Lynn: Good way to store XML data. 

Patty: The ability to edit Fragments and their meta data. Also, the ability to preview. 

Phyllis: The ease of publishing content 

Michelle: Self service tool for content providers. 
Allows sharing of fragments. 

Better organization of pages/content via standardization. 

Dave: Storage of Product data in XML, available to both Web and non-Web platforms from the same 
data source. 

Franklin disadvantages 

Lynn: It seems to be limited in entering data only for products. How does an administrator create new 
style sheets or adjust current ones? 

The Ul needs some work, but we were told not to take that into consideration (a little hard since we 
are trying to use the tool). 

Patty: The user interface needs some improvement, i.e. Colors, help features...Would also like to be 
able to copy an existing fragment/servable and customize to new content 

Phyllis: Franklin does not have workflow capabilities. 

Michelle: The Ul is not very friendly. Need to provide extensive training to users. 
Conversely, the "better organization" of content also means that there is lesser flexibility. 
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Dave: Lack of Ul. It is not intuitive to use, and therefore requires support and customization for any 
group that wants to use it The fact that Franklin is already being used, yet we are going through this 
exercise to evaluate it for TG, is a perfect example of its need to be improved in Ul and flexibility. 

Would you want to use Franklin or similar process/tool? 

Lynn: Yes 

Patty: Yes. However, I am concerned about our content providers. They currently use a home grown 
interface that does not require them to fill in meta-data. Perhaps (just brainstorming) we'd need a 
layer on top of this for those who want to provide content but just use the existing meta data values 
and therefore don't even show them. 

Phyllis: Yes. At this point there is a lengthy turnaround time for content changes since developers are 
given the task of loading content as opposed to content managers/authors. 
Michelle: Yes 

Dave: Yes. Franklin is definitely on the right track. And mentioned previously, if integrated with a more 
complete content solution, it would be a valuable tool. 

What would you most like to change? 

Lynn: The user interface needs to be a little bit more helpful. I would also like to have seen the 
administrator's pt of view. How does a team create new style sheets? 

Patty: I know we didn't use the workflow part, but I'd like to be able to have a baseline for content, so 
when updates are made the reviewer can see what exactly has changed without reading the entire 
piece of content 

Michelle: Friendlier UL Better navigation. 
Dave: User Interface 
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Scenario 2 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 

I 5 

Mean Avg: 3.83 
Comments: 

Carl (Neutral): With or without a content management tool, what we need is a well-ordered, 
well-maintained, user-friendly image library, and when new images are created we need content 
owners to put them into the library. Adopting Franklin (or any other tool) will not automatically cause 
this to happen. 

Lynn: (Satisfied): It allowed me to complete the task. "Content" field should be above "Content 
FileName". When a user browses for an image, they can find it in the local directory then the file 
name just appears in the "Content" field. When browsing for the image, if the user selects one, and it 
is wrong, they have to browse for it again. When they hit that button to browse, the directory is not 
where the user last looked, it is in the Franklin Tool directory. I think it should remember where the 
user looked last 



Patty (Satisfied): Don't think that I, the user, should have to check for duplicate name before creating 
the image. Also, please provide some filename help.J.e. Naming guidelines. 

Phyllis (Satisfied): I was pleased with the tool AFTER I had help from Dikran. For example, in the 
CONTENTFILENAME field I did not know to add a file extension (i.e. jpg) from the error message 
'could not map filename null'. A suggestion for tool improvement is to allow double<licking on fields. 
For example, upon creating a fragment or page, I was hoping to double<lick on the fragment type to 
create it Instead I am forced to click on the CREATE button on the bottom. 

Michelle (Satisfied): Easy to use. Would be great if Franklin can "remember" where I last pulled my 
files from. "Content File Name" - why can't this be pulled from the file name of the gifljpg 
automatically? 

Dave (Satisfied): The form for submitting images is fairly simple and straightforward. It is easy to work 
with, and being able to view the directory structure on the server is a nice touch. However, the Ul is not 
intuitive, and needs work. 



Scenario 3 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 

2 3 I 

Mean Avg: 2.83 (Between Dissatisfied and Neutral) 



Comments: 
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Carl (Dissatisfied): First I couldn't figure out how to get out of "Thumbnail" mode, so I had to shut 
down Franklin and restart it 

Second: I had to re-edit franklin.properties before it would preview the file. The requirement to 
configure franklin.properties will be a huge barrier to most of our prospective content "owners" 
because by and large they are not technical people. With content coming from many people in many 
locations, I see this as a significant barrier to its successful widespread adoption. Rather than 
bottom-line content "owners" uploading content, we will likely end up with a few people on the web 
team doing it 

Third: The Scenario instructions ask you to "refresh tasks assigned to you". I never did figure out how 
to find out what tasks were "assigned to me". I finally ignored this instruction. 
Fourth: When I edited the product page and saved it as a draft, my edits disappeared from the fields 
on the right side of Franklin and the downlevel version reappeared. This is very counter-intuitive. 
Keeping the downlevel version is great, but when you save your edits you should continue to see the 
new version. Each time I checked the document in, my edits would disappear and the downlevel 
version would reappear. 

Fifth: When I checked out the product page, and then did a search, the version I checked out did not 
appear in the search results. It should appear, with a notation that it has been checked out 

Lynn (Neutral): I'm assuming it is a product specialist involved with the creation. 

Patty (Neutral): Insufficient help with error messages. 

Michelle (Neutral): Navigation is difficult especially between search window and main window. "Right 
click" functions would help. 

The instructions are not clear. Some steps don't seem relevant 

Would be very helpful if each meta data has a detail/brief description. Maybe this is not so bad for 
someone who knows the product well. I am not well versed, so I have difficulty. 
Got an error message - "Automation server cannot create object" after Step #18. Dikran said it's a 
security problem. 

Dave (Dissatisfied): The form is too complex for end users. The people who write the content for 
product pages are not technical. Based on our experiences with the first generation of our content 
management tool, if the forms are too complex, even with training, the system just won't get used. The 
process of filling out the form and submitting is fine, but the form needs to be simplified, and the 
terminology on each field has to be written in English, not the field names that make sense to the 
system programmers. 

Scenario 4 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 

3 2 

Mean Avg: 3.4 (Between Neutral and Satisfied) 
Comments: 
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Lynn (Neutral): The tool wasn't checking in at all I tried to modify all the fields and they didn't work 
until I cut out the registered symbol in the summary. Then it checked-in fine. The exact error was, " 
an error parsing input stream". 

Phyllis (Neutral): After I had checked the page in I had gotten the message 'can not preview this page'. 
Does this have something to do with the style sheet for PDA? 

Michelle (Neutral): Instructions not clear. Followed instructions but the PDA link did not show up at the 
"approval pages" stage. Dikran tried it and the PDA link showed up on his pc 

Dave (Satisfied): The process works, and if the page is already created, the form does not seem as 
daunting as when creating a page from scratch. However, had I not already been shown how to add 
the PDA style sheets, I would have had trouble figuring it out on my own, and the style sheets/layout 
are not visually separated from the rest of the fields on the form. 

Scenario 5 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 

2 2 I 

Mean Avg: 3.8 (Between Neutral and Satisfied) 
Comments: 

Lynn (Satisfied): The general thought of capturing data like this is great The ill is a problem. 
Assuming the person entering in the info is a product specialist, it still doesn't specify whether MB 
should be entered for memory or just a number. 

Phyllis: (Neutral) I had tried to preview my fragment but every time I had clicked on the preview icon 
nothing happened. 

Michelle (Neutral): No explanation of each meta data. A product specialist might know but I am not 
well versed. Had some difficulties understand the fields required. 

Dave (Satisfied): Again, aside from Ul complaints, the tool does the job intended. 

Scenario 6 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 

I 4 

Mean Avg: 3.8 (Between Neutral and Satisfied) 
Comments: 

Lynn (Satisfied): I think the purpose behind it is great The product is good at enabling the user to 
complete this scenario. But wlo directions, I would have been lost I used product specs created by 
other people that were already published. I didn't understand why they needed to be 
checked-in/published again for my task. 
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Phyllis (Satisfied): The tool is excellent I just had difficulty adding a product spec since my screen did 
not display the '+* sign to the right of the field. Without asking Dikran, I would not have known to 
scroll to the right of the screen to click on the sign. 

Michelle (Neutral): Suggest that the "price" meta data field indicate that the is default If not, end 
up with values like "$$3500" 

My thumbnail did not show up. Dikran explained that it is in the index page and not product 
comparison page. 

My Product Comparison page did not show up. The page also did not show up in the search function. 
Recreated the pages twice using different names (replaced "8c" with "_" because of XML) . Still did 
not show up. "The requested URUweblProdCompA8cT.html was not found on this server." 

"Caps" or "no caps" for user name/creator field. I logged on Friday under "Michelle Um". I logged on 
Monday under "michelle lim". When I do searches by creator, I get different results when I use 
"Michelle Um" and "michelle lim". It's confusing. 

Scenario 7 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 

3 2 

Mean Avg: 4.4 (Between Satisfied and Very Satisfied) 
Comments: 

Lynn (Satisfied): Allows the user to click around the site and easily change the page. 

Patty (Very Satisfied): I'm extremely impressed with the functionality to retrieve based on URL 

Phyllis (Satisfied): This functionality is excellent The only difficulty I had encountered was checking out 
the subfragment. I did not see the icon to the right of the product spec field. I kept copying the 
fragment id of the subfragment and going to TILE CHECK OUT WITH FRAGMENT ID\ which did not 
change the right-side of the screen. 

Michelle (Very Satisfied): This part is easy. =) 



Scenario 8 

Very 



Dissatisfied Neutral Satisfied Very 
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Dissatisfied 

I 



I 



Satisfied 



Comments: 

Lynn (Dissatisfied): I couldn't just type the id in the field. I had no conflict report or it wasn't apparent 
as to where it was. 

Phyllis: I could not type the fragmentid into the appropriate field. I did not receive an error message 
stating that another was using the field either. Hence, I could not complete this task. 

Michelle (Neutral): The check out by fragment ID window..., only accepts a cut and paste of the ID. 
Does not allow direct entry into the box. 

Did not get a message that the fragment is locked but a conflict report did come up. However, was 
not given the option to click "OK" and check out anyway (Step #4). Could not evaluate. 

Dave: NIA - There were no tasks in the system, so this scenario did not function as the test described 

Scenario 9 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 

I 

Comments: 

Lynn: I had no one to work with on this. 

Phyllis: There were no colleagues to test this with. Hence, I did not complete this scenario. 

Michelle: Could not evaluate with another user. 

Dave: NIA - 1 was working alone, so could not test with another user. 

Discussion 

The Franklin team may want to establish short-term and long-term goals for the Franklin content 
management system. In the short-term, the team could provide many of the fixes that participants in 
tfi/s evaluation recommended. In the long-term, the team could examine different possible views and 
mechanisms for interacting with servables and fragments, and provide the optimal solution. Providing 
the smaller fixes will increase user satisfaction, and the ease of completing tasks. The long-term work 
will address the underlying or deeper causes for the participants disliking the current ill, and will likely 
make a bigger impact on increasing ease of use and user satisfaction. 

Short-term fixes can help users learn the interface, and minimize problems if users' conceptual model 
differs from the model upon which Franklin operates. For instance, the search button is the only button 
operable in the initial view of Franklin. This button, however, is gray and appears too similar in state to 
the other buttons that are inoperable at th/s point Providing a better visual cue that users can begin 
work by clicking the search button, and implementing other improvements that users in this evaluation 
recommended, can go a long way toward improving the usability of Franklin. 
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That all of the participants listed the ill as the primary disadvantage of the product suggests that 
these short-term fixes will not arrive at the optimal solution for interacting with servables and 
fragments, however. More work needs to be done to arrive at a solution that matches the user's 
conceptual model 

A few of the bigger issues that need to be addressed are: 

• What is the base view for interacting with servables and fragments? 

• What is the start view for interacting with servables and fragments, and is it different from the 
base view? 

• Do users want/need additional views or mechanisms for interacting with servables and fragments? 

• How do users conceptualize organizing fragments and servables? 

• How do users conceptualize accessing servables and fragments? 

• How do users conceptualize moving from a view of documents in a library to a work view? 

Franklin currently opens into the work-plane view in which no documents are visible to beginning users. 
This view could also be considered the base view. One reason users may find Franklin initially difficult to 
use is because much of the functionality is initially hidden. There are not many cues for how to begin. 
An alternative design solution would be to open into a library or browsable view of documents provides 
a search interface for finding and checking out fragments and servables. It may be that users would 
prefer the library of documents, and the ability to preview documents, to be the base view. 

Currently, users enter parameters and search for documents they want to work with, or they can 
retrieve documents based on the URL The search functionality and retrieve based on a URL are both 
very useful tools, but users might like additional functionality and additional views of the content 
Currently, users cannot see from the search interface how documents are organized. Providing a 
browsable library could be one means of providing an overview of the page types, or servables, and the 
fragments that constitute the pages. The library, in the form of a simple tree structure for example, 
could facilitate accessing fragments by the servables that contain them, which in turn could give users 
additional cues as to which fragments are used to create specific servables. 
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codeRevi ew 

- positioning for deeply indented dtds (ie not in iv_mainPane) 

- I noticed one oddity when using the +/-: I added 2 list items to 
listfragment and i only filled in linktitle and description, i 
checked it in, then checked it back out. now when i add more list 
items using +/- , it only adds linktitle and description, not the 4 
fields that should be there, do you know what might be going on? i 
can show you on Monday if this description is cryptic... 

- checkoutForview (like checkout without lock) 

implement checkoutForview which is a GET without lock token 

flag on fragment, iv_readOnly = false; 

from either active list or search can do a getForview 

- put into edit window (right side) without being able to modify 
disable the checkin button for read only fragments 

- title bar include READ only "-- Read only 
[weird cases: 

;i viewing fragment, now want to check it out, can't easily do it] 

.2 if viewing fragment, then search and do a checkout, it will just go 

to existing fragment, which is still in read mode] 
[3 test... with new icons] 



- Logout... prompt to unlock all checked out fragments or keep for editing 
choose which to save locally 

offline editing: dtd, save xml file, multimedia file, locktoken 
on login fill in right side with locally saved fragments 

1. unlock unwanted fragments. 

2. save dtd & xml & multimedia files 

- offline editing without checking into server, use local dtds. 

- stale sessionlD put up dialog for every sc_unauthorized 

- show media file for browseLocal (eg, image) on browseLocal entry 

- publish info has 3 children: stylesheet is not properly indented 

- copy and create 

- search nresults print, results in message pane 

- captitalize font (and smaller) for table headings... 

- (tagl | tag2)* method hasQualifier doesnt find model with () groupings 

- chuek button for audio fragment, checkoutForview 

- change login init file name ie "franklin_init.xml n -> "/login" 
synch with jeff 
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Scott Smiley 

From: Jon Gibbons 
Sent: 

To: Scott Smiley 
Subject: FW: Franklin Editor Ul 




From: Dikran S Meliksetian [mailto:Dikran_Meliksetian@us.ibm.com] 
Sent: 

To: Jon Gibbons 

Cc: Louis Weitzman; Sara Elo-Dean 
Subject: Fw: Franklin Editor UI 



Jon, 

Here is a note dated : t invites folks outside the franklin team to download/install and use the franklin 

client. 

We are still looking at earlier reference of the working system which we believe should be ir. 

imeframe. The attached note indicates that early February we had robust working code and manuals taht 
could be delivered to potential customers. 



Dikran 



• Forwarded by Dikran S Meliksetian/South bury/IBM on 



Sara Elo/Armonk/IBM Ron Lautmann/Mountain View/IBM@IBMUS, John 

To Dorvai/Somers/IBM@IBMUS, Stephen Kennedy/Somers/IBM@IBMUS, Patrick 
Rooney/Boulder/IBM@IBMUS 

cc Franklin, Maria Hemandez/Somers/IBM@IBMUS 
Subject Franklin Editor Ul 



Hi all, 



Install: 

Please go to http://monolith.adtech.intemet.ibm.com/franklin/downloads/index.html for 
"How to download Franklin Editor Ul" and 
"How to get started with Franklin Ul" 

Once you have the client installed and running you might want to try the following things: 
Try out: 

1) Search for "Document Type = SoftwareSalesManual", Check-Out from the server the fragment entitled 
"Net. Commerce". This is based on the DTD Patrick provided, filled in with Net. Commerce data. Feel free to 
create a new SWSalesManual fragment to see how the authoring works. 
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2) Search for "Document Type = SWSALESMANUALPAGE" and select the ,, Net.Commerce ,, servable you get 
back. This is a page that imports the fragment in 1) If you merge this document into your Active List, you can 
preview it to see how a page gets rendered into HTML using LotusXSL. You can also check it out to see its 
contents. 

3) Search for "Document Type = PRODUCTPAGE". Check-Out from the server the "Netfinity" servable and 
Preview it. This is another example of a Page made up of 4 subfragments rendered in HTML. 

4) Go wild, create any fragments and pages to get a feel for the editor. The current server is a play space. 
Caveats: 

- Please ignore anything entitled "Test" in the search results. Those are our tests... 

- In the SWSalesManual, the fields containing <P> <LI> etc... are not yet rendered correctly in the final HTML. 
We are working on integrating the mechanism, small matter of programming... 

User Names: 

Below are your usernames and passwords for the Franklin Editor: 
<USER> 

<NAME>Ron Lautmann</NAME> 

<EMAIL>lautmann@us.ibm.com</EMAIL> 

<PASSWORD>ron</PASSWORD> 

<ROLE>Editor</ROLE> 
</USER> 
<USER> 

<NAME>John Dorval</NAME> 

<EMAIL>dorval@us.ibm.com</EMAIL> 

<PASSWORD>john</PASSWORD> 

<ROLE>Editor</ROLE> 
</USER> 
<USER> 

<NAME>Stephen Kennedy</NAME> 
<EMAIL>stephen@us.ibm.com</EMAIL> 
<PASSWORD>stephen</PASSWORD> 
<ROLE>Editor</ROLE> 
</USER> 
<USER> 

- -<NAME>Patrick Rooney</NAME> 
<EMAIL>rooney@us.ibm.com</EMAIL> 
<PASSWORD>patrick</PASSWORD> 
<ROLE>Editor</ROLE> 

</USER> 
</USERS> 



Don't forget that tooltips exist for all icons.... 

Comments, bug reports welcome, please send to me and ill pass on... 

Regards, 
Sara 



Advanced Internet Technology 



http://w3.webahead.ibm.com 
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Scott Smiley 

From: Jon Gibbons 
Sent: 

To: Scott Smiley 
Subject: FW: Franklin Editor Ul 




From: Dikran S Meliksetian [mailto:Dikran_Meliksetian@us.ibm.conn] 
Sent: 

To: Jon Gibbons 

Cc: Louis Weitzman; Sara Elo-Dean 
Subject: Fw: Franklin Editor UI 



Jon, 

Here is another email in response to the previous one that has comments in it. 
I do not think we will be able to find the code from that period. 

Dikran 

— Forwarded by Dikran S Meliksetian/South bury/IBM on 
To: John Dorval/Somers/IBM@IBMUS 

cc: Louis Weifeman/South bury/IBM, Dikran S Meliksetian/Southbury/IBM@IBMUS 
From: Sara Elo/Armonk/IBM@IBMUS 
Subject: Re: Franklin Editor Ul Link 

hi John, thanks for the feedback, below are some answers in blue 

also cc:ing Louis, who developed the Ul, in case he has something to add. 

Sara 
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To: Sara Elo/Armonk/IBM 

cc: 

From; John Dorval/Somers/IBM@IBMUS 
Subject: Re: Franklin Editor Ul Link 

Sara, 

Thanks it installed no problem. Your team is doing a terrific job. I'm very impressed with the functionality. 
Don't take any of the following comments as criticism ~ they are just suggestions for improvements. 



4/4/2005 
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- Usually "check out" means to freeze the document while I 'edit' it. 
Franklin checkout seems to mean view it (read only). 

Actually "Check out" does mean to freeze it for edit. Did you notice that there are two check-out buttons side by 
side? 

The tooltips and the icons themselves can be improved to be singificanlty different: 
"Check out document" and "View document" 
instead of 

"Check out fragment or servable" and "Check out fragment or servable in read only mode" 
good point. 

- ISO codes should be stored with the document along with Country name, 
language, etc. 

The ISO code is actually more important since an appl can look up the name 
given the ISO code. 

We thought long about this with Patrick Rooney. It seems that it will be better for editors to select from the names 
not the codes, 

as names are more readable. However, if the editor chooses a name, then the code should be filled in 
automatically by consulting 

the infamous centralized taxonomy server, or a local automatically updated copy of it on the Franklin server, when 
the document is checked in. 

In the case of other code+name pairs, such as IBM divisions, again, it's more likely that a name might change but 
the code 

stays the same, so the code should always be the one searched upon and used server side, but the name should 
be displayed 

to the user for viewing or selection. 

This is not implemented but is a possible way to do it if we go into pilot 

- For items with multiple paragraphs (ie prod description in the Net.commerce 
entry), need way to mark the paragraphs. The xhtml work that Patrick is doing 
may help here. 

yes, that's the functionality we are currently adding... stay tuned 

- There is a paste button on the "Read Only" form. Probably not needed, 
good point. 

- Got an SAX exception checking out the Netfinity product page 
ah, we will check 

- Just a general comment, I know it is hard to do but having a wsiwig 
authoring tool is important. Business uses don't want to see the tags or have 
to typeihem. The eSites requirements folks were very strong on that 

point. 

yes, i realize this is becoming the biggest issue here.... 

- Not sure where some of your button icons come from (maybe they are unix 
versions which I am unfamilair with). I believe most users will be Windows users so 




- The shades of gray used for the windows us different than the default windows colors 
and it makes the appl look a little out of place - again maybe this is a unix color scheme. 



Of course, this is all nit picky stuff so I'll stop here. 
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Thanks. 
Regards, John 



Enterprise Web Management, Advanced e-Business Technology 
Route 100 Somers NY 

Tel. (914) 766-1515 TI 826 Fax x-1869 
Internet: dorvaI@us.ibm.com 

To: Ron Lautmann/Mountain View/IBM@IBMUS, John Dorvai/Somers/IBM@lBMUS, Stephen Kennedy/Somers/IBM@IBMUS, Patrick 
Rooney/Boulder/IBM@IBMUS 

cc: Franklin, Maria Hemandez/Somers/IBM@IBMUS 
From: Sara Elo/Armonk/IBM@IBMUS 
Subject: Franklin Editor U I 



Hi all, 
Install: 

Please go to http://monolith.adtech.internet.ibm.com/franklin/downloads/index.html for 
"How to download Franklin Editor Ul" and 
"How to get started with Franklin Ul" 

Once you have the client installed and running you might want to try the following things: 
Try out: 

1) Search for "Document Type = SoftwareSalesManual", Check-Out from the server the fragment entitled 
"Net. Commerce". This is based on the DTD Patrick provided, filled in with Net.Commerce data. Feel free to 
create a new SWSalesManual fragment to see how the authoring works. 

2) Search for "Document Type = SWSALESMANUALPAGE" and select the "Net. Commerce" servable you get 
back. This is a page that imports the fragment in 1) If you merge this document into your Active List, you can 
preview it to see how a page gets rendered into HTML using LotusXSL. You can also check it out to see its 
contents. 

3) Search for "Document Type = PRODUCTPAGE". Check-Out from the server the "Netfinity" servable and 
Preview it. This is another example of a Page made up of 4 subfragments rendered in HTML. 

4) Go wild, create any fragments and pages to get a feel for the editor. The current server is a play space. 
Caveats: 

- Please ignore anything entitled "Test" in the search results. Those are our tests... 

- In the SWSalesManual, the fields containing <P> <LI> etc... are not yet rendered correctly in the final HTML. 
We are working on integrating the mechanism, small matter of programming... 

User Names: 

Below are your usernames and passwords for the Franklin Editor: 
<USER> 

<NAME>Ron Lautmann</NAME> 

<EMAIL>lautmann@us.ibm.com</EMAIL> 

<PASSWORD>ron</PASSWORD> 

<ROLE>Editor</ROLE> 



Page 4 of 4 



</USER> 
<USER> 

<NAME>John Dorval</NAME> 
<EMAIL>dorval@us.ibm.com</EMAIL> 
<PASSWORD>john</PASSWORD> 
<ROLE>Editor</ROLE> 
</USER> 
<USER> 

<NAME>Stephen Kennedy</NAME> 
<EMAIL>stephen@us.ibm.com</EMAIL> 
<PASSWORD>stephen</PASSWORD> 
<ROLE>Editor</ROLE> 
</USER> 
<USER> 

< NAM E> Patrick Rooney</NAME> 
<EMAI L> rooney @us. ibm. com</EM Al L> 
<PASSWORD>patrick</PASSWORD> 
<ROLE>Editor</ROLE> 

</USER> 
</USERS> 



Don't forget that tooltips exist for all icons.... 

Comments, bug reports welcome, please send to me and i'll pass 

Regards, 
Sara 



Advanced Internet Technology 
http://w3.webahead.ibm.com 
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<?xml version="1.0" encoding="US-ASCH" ?> 

<!DOCTYPE FRANKUNJNIT (View Source for full doctype...)> 

<FRANKLINJNIT> 

- < FRAG ME NTS displayname="Fragment"> 

<DTD displayname="Text" 
href=http://frasier.dhcp.adtech. internet. ibm.^^ 

<DTD displayname="lmage" 

href= http://frasier.dhcp.adtechJnternetJbm.eom/franklin/xml/imagefragment.d 

<DTD displayname="Audio n 

href= http://frasier.dhcp.adtech.internet.ibm.com/franklin/xml/audiofragment.dl 

<DTD dispiayname="Video" 

href="http://frasier.dhcp.adtech. internet. ibm.com/frankSin/xml/videofragment.dt 

</FRAGMENTS> 

- <SERVABLES displayname="Page"> 

<DTD displayname="Page one" 
href =^ http://frasier.dhcp.adtech.internet.ibm.com/franklin/xml/servableone.dtd ' 

<DTD displayname="Page two" 

href^ http://frasier.dhcp.adtech.internet.ibm.com/franklin/xml/servabletwo.dtd ' 

<DTD displaynarne="Page three" 
href = http://frasier.dhcp.adtech.internet.ibm.com/franklin/xml/foo.dtd ' /> 

</SERVABLES> 

- < SEARCH > 

- <ATTRIBUTELIST> 

< ATTRIBUTE displayname="Creation Date" name="CREATIONTIME" 

class="Time" /> 
< ATTRIBUTE displayname="Last Modified Date" 

name= LASTMODIFIEDTIME class= "Time" /> 
< ATTRIBUTE displayname="Content Size" name="CONTENTSIZE" 

class="Integer" /> 
< ATTRIBUTE displayname="Creator" name="CREATOR n class="Name" /> 
< ATTRIBUTE displayname="Title" name= ,, TITLE" class ="Text n /> 
<ATTRIBUTE displayname="Source" name="SOURCE" class="Text" /> 
< ATTRIBUTE displayname = "Comment" name= "COMMENT" class="Text" /> 
< ATTRIBUTE displayname="Keyword" na me = " KEYWORD " class="Text" /> 
< ATTRIBUTE displayname = "Type" name="TYPE" class="Selection" 

options= ,, http://frasier/franklin/dtd/entities/types-xm^ , /> 
< ATTRIBUTE displayname="Category" name-"CATEGORY" class="Selection" 

options- http://frasier/franklin/dtd/entities/categories.xml n /> 
" ~< / ATTRI BUTE LIST> 

- <CL^SSLIST> 

- <CLASS name= n Time"> 

<OPERATOR>> = </OPERATOR> 
<OPERATORX = </OPERATOR> 
<OPERATOR> = </OPERATOR> 
<VALUE type="date" /> 
</CLASS> 

- <CLASS name="Integer"> 

<OPERATOR>>=</OPERATOR> 
<OPERATORX = </OPERATOR> 
<OPERATOR> = </OPERATOR> 
<VALUE type="integer" /> 
</CLASS> 

- <CLASS name="Name"> 
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<OPERATOR>is</OPERATOR> 
<OPERATOR>isn , t</OPERATOR> 
<OPERATOR>starts with</OPERATOR> 
<VALUE type="string" /> 
</CLASS> 

- < CLASS name="Text"> 

<OPERATOR>is</OPERATOR> 
<OPERATOR>starts with</OPERATOR> 
<VALUE type="string" /> 
</CLASS> 

- <CLASS name="Selection"> 

<OPERATOR>is</OPERATOR> 
<OPERATOR>isn't</OPERATOR> 
<VALUE type="drop-down" /> 
</CLASS> 
</CLASSLIST> 
- <RESULTS> 

< ATTRIBUTE displayname="Last Modified Date" 

na me = " LASTMODI FI EDTIM E" class="Time" /> 
< ATTRIBUTE displayname= "Creator" name= "CREATOR" class="Name" /> 
< ATTRIBUTE displayname= "Title" name="TITLE" class="Text" /> 
< ATTRIBUTE displayname="Type" name="TYPE" class="Text" /> 
</RESULTS> 
</SEARCH> 
</FRANKLIN_INIT> 
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